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Preface 



This publication provides information for system programmers who are to install the job 
entry subsystem JES2 Release 4.0 (JES2 Release 4.0 is associated with the ID 
VS2.03.803.) This information formerly was found in the JES2 sections of OS/VS2 
System Programming Library: System Generation Reference, OS/VS2 System Program- 
ming Library: Initialization and Tuning Guide, and OS/VS2 System Programming 
Library: Job Management. 

This manual consists of seven chapters that include information about the installation and 
initialization of JES2, JES2 processing, remote job entry supported by JES2, and factors 
that affect JES2 performance. 

Chapter 1, "Introduction to JES2," briefly describes the job entry subsystem. It also 
provides short descriptions of JES2 generation and initialization, RMT generation, and 
JES2 processing. 

Chapter 2, "Installing JES2," provides information needed to install JES2. This chapter 
discusses the programming requirements for JES2 and RMT generations and includes 
information about the generating system, the distribution libraries, and the required spool 
data sets. The processing of a JES2 generation is also described. (RMT parameters and the 
execution of an RMT generation are described in Chapter 5.) 

Chapter 3, "JES2 Initialization," describes the JES2 initialization procedure.. The chapter 
includes the meaning and use of each of the initialization parameters and the rules for 
coding the parameters. It also contains descriptions of starting and restarting JES2. 

Chapter 4, "JES2 Processing," discusses how you can affect JES2 processing by means of 
the JES2 initialization parameters and the JES2 operator commands. The chapter 
describes configuration, job submission and queuing, conversion and execution, and 
output. 

Chapter 5, "Remote Job Entry," contains information about remote devices supported 
by JES2, the RMT generation procedure (including the RMT parameters and the 
execution of an RMT generation), and the operation of a remote station. 

Chapter 6, "Miscellaneous JES2 Facilities," describes automatic command processing, the 
JES2 patching facility, the flow for time-sharing and started tasks, and the multi-access 
spool configuration. 

Chapter 7, "JES2 Performance," discusses factors affecting JES2 performance, operator 
control of the batch job workload, a comparison of HASP II Version 4.0 and JES2 
performance factors, and changing the JES2 "nonswappable" property to "privileged." 
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CHAPTER 1. INTRODUCTION TO JES2 
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JES2 is a job entry subsystem, provided with MVS, that is generally compatible with 
HASP II. JES2 serves as the point of entry for all jobs and produces all hard copy job 
output. To accomplish these functions, JES2 controls local and remote job entry devices 
and output devices. A special job entry source, the internal reader facility, allows MVS to 
submit system jobs: started tasks and time-sharing logons. Tape and disk input are also 
supported through the internal reader facility. See Figure 1-1 for input/output 
relationships to the job entry subsystem and MVS. 

An output interface allows MVS to retrieve output for TSO terminals and allows a special 
output facility— the external writer-to process output to tape, disk, and installation- 
written writer routines. The output interface also supports an output facility to the 3540 
diskette writer (see OS/VS2 IBM 3540 Programmer's Reference). 

While the job is in MVS, the JES2 job queue residing in pageable storage maintains a 
record for the job. Job-related system records plus records related to job input and 
output are maintained on external spool volumes. 
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Figure 1-1. JES2 I/O Relationships 
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JES2 Processing: By means of RMT generation and JES2 initialization, you can define 
and control the configuration of job entry sources and job output destinations. JES2 
provides centralized control of job input, queuing, and output, so that all jobs are 
controlled in the same manner whether submitted from local or remote job entry devices, 
or through the internal reader facility. 

JES2 Generation: The JES2 generation procedure, which is the process of installing 
JES2, has two parts. The first part, JES2GEN, may be performed while Stage II of system 
generation is in progress. It consists of assembling the job entry subsystem from source 
modules that optionally have been updated to include any user modifications. During the 
second part, JES2BLD, the assembled object modules are link-edited into the MVS 
system control program. 

Before you attempt to install JES2 programs, you should be familiar with the 
information about JES2 programs in- this chapter and in the chapters "Remote Job 
Entry" and "JES2 Initialization." 

RMT Generation: In addition to installing JES2, you may also generate one or more 
JES2 MULTI-LEAVING remote terminal processor (RTP) programs. The RTP programs 
allow jobs to be submitted from a remote terminal to the job entry subsystem in the 
central computer for processing. 

JES2 Initialization: Initialization is JES2's means of readying itself for processing. JES2 
performs an initialization the first time it is started and every time it is restarted after a 
normal shutdown or after a system failure. By specifying a set of initialization 
parameters, you indicate which of the JES2 functions and devices are to be initialized; 
the initialization parameters define the functions and device characteristics JES2 uses 
during its execution. 
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Overview 



The process of installing JES2 is referred to as JES2 generation. JES2 generation consists 
of creating the JES2 source library (SYS1.HASPSRC), assembling the JES2 source 
modules into the JES2 object library (SYS1.HASPOBJ), and link-editing the assembled 
object modules into the MVS load module libraries (SYS1.LINKLIB and SYS1.LPALIB). 

Once JES2 has been installed, partial JES2 generations may be performed for minor 
changes. Instead of all of the JES2 modules being reassembled, only those modules to be 
modified are reassembled and link-edited. 

After the JES2 generation, you can perform an RMT generation to generate JES2 
MULTI-LEAVING remote terminal processor (RTP) programs for job entry from remote 
terminals. The RTP programs are punched as self-loading object decks. The RTP programs 
that can be generated are: 

• System/360 and System/370 binary synchronous communication (BSC) RTP program 

• System/360 Model 20 BSC RTP program (including the 2922 RTP program) 

• 1130 RTP program 

• 1130 loader program 

• System/3 RTP program 

This chapter describes the procedures required for JES2 and RMT generation (for 
example, those for allocating space and cataloging) and the spool data sets required for 
job processing after generation. It also contains detailed information about executing 
programs to install JES2. For a description of the RMT parameters and the processing 
involved in an RMT generation, refer to Chapter 5. 



Installing JES2 requires a generating system to "drive" the JES2 generation process and 
perform the other jobs that must be done before job processing can begin. In addition, 
the following are required: 

1. The distribution libraries must be copied from the PID distribution library tapes to 
direct-access storage. 

2. The data sets that are required to contain the source and object modules that are 
used during processing must be defined. 

3. If changes are to be applied to the source code, these changes are specified in update 
control statements. 

4. Execute the programs to install JES2. 

The following sections give detailed information that applies to both JES2 and RMT 
generation for the first two steps. Information about the last two steps for JES2 
generation is also contained in the following sections. Further information about RMT 
generation is included in Chapter 5. 



Requirements for JES2 and RMT Generation 



JES2 and RMT generations require an MVS system control program for use as the 
generating system and four distribution libraries. 
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The Generating System 



For the first JES2 generation, a starter system that is provided by IBM must be used. The 
starter system is a minimum MVS system control program that contains all of the 
programs and procedures required for JES2 and RMT generations. After the first JES2 
generation using the starter system, an existing VS2 system control program of a current 
release can be used for subsequent JES2 and RMT generations. 



The Distribution 
Libraries 



The distribution libraries are distributed by IBM as unloaded partitioned data sets on 
magnetic tape. They contain all of the macro definitions and components necessary to 
install a system control program as well as to install the job entry subsystem and generate 
RTP programs. 

The contents of the distribution libraries must be copied to direct-access volumes prior to 
the JES2 and RMT generations. These volumes must be mounted during the JES2 and 
RMT generations. Refer to OS/VS2 System Programming Library: System Generation 
Reference for information about copying the distribution libraries to direct-access 
volumes. 

Four of the distribution libraries are required for JES2 and RMT generations: 
SYS1 AMODGEN, SYS1 AMACLIB, SYS1.AOSH1, and SYS1.AOSH2. SYS1.AMODGEN 
and SYS 1. AMACLIB contain macro definitions and components that are used during 
JES2 and RMT generation. SYS1.AOSH1 and SYS1.AOSH2 contain the following: 

SYS1.AOSH1 : This distribution library contains the following utility programs: 

JESIIGEN A utility program that uses the library SYS1.AOSH2 and a data set 

containing user source modifications, if any, as input to create the 
library SYSl.HASPSRC. SYS1.HASPSRC then contains the JES2 
and RTP program source modules. 

REMOTGEN A utility program that acts as a monitor linking to other remote 
terminal utility programs and to the assembler during an RMT 
generation. 

GENRMT A utility program that reads the card input stream during RMT 

generation for the RTP program identification, selects the 
appropriate standard option list for the RTP program to be 
generated, prints the parameter default values, and updates the 
source modules with the changes read from the RMT parameters. 



LETRRIP This utility program is an 1130 post-processor that creates an 1130 

object-deck image on the SYSPUNCH data set. 

SYS3CNVT This utility program is a System/3 post-processor that produces an 

object-deck image on the SYSPUNCH data set. 

SYS1.AOSH2: This distribution library has two members. One member contains all 

of the JES2 and RTP program source modules in a form suitable as 
input to the JESIIGEN utility program. The other member contains 
any maintenance updates to these source modules, also in a form 
suitable as input to JESIIGEN. 



Defining the Data Sets for Generation 



Before JES2 can be installed and RTP programs can be generated, space must be allocated 
to the two data sets that are used during JES2 and RMT generations, and they must be 
cataloged in the master catalog of the generating system. Before JES2 can be initialized, 
at least one spool data set must have space allocated for it. Although spool data sets are 
not required for a JES2 generation, space can be allocated at the same time the required 
data sets are defined. 

This section gives information about the required data sets, SYS1.HASPSRC and 
SYS1.HASPOBJ, the data set or sets used for spooling, SYS1.HASPACE, and the data set 
used for the two checkpoint records of JES2, SYS1.HASPCKPT. The space allocations 
that are given for the data sets are recommended when full volume allocation is not used. 



SYS1.HASPSRC 



SYS1.HASPSRC is a partitioned data set that contains JES2 and RTP program source 
modules. Figure 2-1 lists the contents of SYS1.HASPSRC after the contents of the 
SYS1.AOSH2 distribution library have been placed into it. 



Requirements for 
Specification 



Location: This data set musf be on a direct-access volume. The volume that contains this 
data set can be on any of the storage devices listed in Figure 2-2. 



Member Names 



Description 



SYS1.HASPSRC 



$$POST thru $XMPOST 

HASPACCT 

HASPCOMM 

HASPCON 

HASPDOC 

HASPINIT 

HASPMISC 

HASPNUC 

HASPPRPU 

HASPRDFL 

HASPRTAM 

HASPSSSM 

HASPXEQ 

HRTPB360 

HRTPLOAD 

HRTPOPTS 

HRTPSYS3 

HRTP1130 

NULL 



JES2 Macros 

Accounting Routine 

Command Processor 

Console Support 

Control Block Documentation 

Initialization Routine 

Miscellaneous Routines 

JES2 Nucleus 

Print/Punch Processor 

Input Processor 

Remote Support 

Subsystem Support Module 

Execution Processors 

System/360 and M20 BSC Remote Program 

1 130 Loader Program 

RMTGEN Standard Option Lists 

System/3 Remote Program 

1130 Remote Program 

JES2 Macro 



Figure 2-1 . Contents of SYS1 .HASPSRC 



2305 Model 1 Fixed Head Storage 
2305 Model 2 Fixed Head Storage 
2314/2319 Direct Access Storage Facility 
3330/3333 Model 1 Disk Storage and Control 
3330/3333 Model 1 1 Disk Storage and Control 
3340/3344 Direct Access Storage Facility 
3350 Direct Access Storage 



Figure 2-2. Storage Devices for JES2 Data Sets 
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Space Allocation: Space allocation for this data set is: 
SPACE=(1680,(4000,200,10)) * 

The following DCB subparameters must be specified: 
RECFM=FB,LRECL=80,BLKSIZE= 1 680 

Cataloging: This data set must be cataloged in the master catalog of the generating 
system. 

Refer to Figure 2-4 for an example of defining this data set. 



SYSLHASPOBJ 



SYS1.HASPOBJ is a partitioned data set that contains object modules that have been 
assembled from the source modules in SYS1.HASPSRC. Figure 2-3 lists the contents of 
SYSLHASPOBJ after the JES2 object modules have been assembled into it. 



Requirements for 
Specification 



Location: This data set must be on a direct-access volume. The volume that contains this 
data set can be on any of the storage devices listed in Figure 2-2. 

Space Allocation: Space allocation for this data set is: 
SPACE=(400,(500,100,10)) 



The following DCB subparameters must be specified: 
RECFM=FB,LRECL=80,BLKSIZE=400 

Cataloging: This data set must be cataloged in the master catalog of the generating 
system. 

Refer to Figure 2-4 for an example of defining this data set. 



SYSLHASPCKPT 



SYS1.HASPCKPT is used for the two checkpoint records of JES2. 



Requirements for 
Specification 



Name Convention: The data set must be named SYSLHASPCKPT and must exist on the 
checkpoint volume whose volume serial number is specified by the JES2 initialization 
parameter &CHKPT. If &CHKPT is not specified, SPOOL1 or the value of the JES2 
initialization parameter &SPOOL is used for the volume serial number. The JES2 
initialization parameters (&SPOOL and &CHKPT) are described in Chapter 3. 



Member Names 



Description 



SYSLHASPOBJ 



HASPACCT 

HASPCOMM 

HASPCON 

HASPINIT 

HASPMISC 

HASPNUC 

HASPPRPU 

HASPRDR 

HASPRTAM 

HASPSSSM 

HASPXEQ 



Accounting Routine 
Command Processor 
Console Support 
Initialization Routine 
Miscellaneous Routines 
JES2 Nucleus 
Print/Punch Processor 
Input Processor 
Remote Support 
Subsystem Support Module 
Execution Processors 



Figure 2-3. Contents of SYSLHASPOBJ 



//ALLOCATE 


JOB 


//ALLOCAT 


EXEC 


//HASPSRC 


DD 


II 




II 




//HASPOBJ 


DD 


// 




II 




//SPOOL1 


DD 


II 




II 




//SPOOL2 


DD 


II 




II 




//CHKPT 


DD 


II 





(. . J/PREPARE FOR JES2GEN',MSGLEVEL=1 

PGM=IEFBR14 

DSN=SYS1.HASPSRC,UNIT=SYSDA,VOL=SER=JES2, 

DISP=(NEW,CATLG),SPACE=(1680,(3600 / 200,10)), 

DCB=(RECFM=FB,LRECL=80,BLKSIZE=1680) 

DSN=SYS1.HASPOBJ,UNIT=SYSDA,VOL=SER=JES2, 

DISP=(NEW,CATLG),SPACE=(400,(400,100,10)), 

DCB=(RECFM=FB,LRECL=80,BLKSIZE=400) 

DSN=SYS1.HASPACE,UNIT=3330,VOLUME=SER=SPOOL1, 

DISP=(NEW,KEEP),SPACE=(ABSTR,(7642,2)), 

LABEL=EXPDT=99366 

DSN=SYS1.HASPACE,UNIT=2314,VOLUME=SER=SPOOL2, 

DISP=(NEW,KEEP),SPACE=(ABSTR ( (3998,2)), 

LABEL=EXPDT=99366 

DSN=SYS1.HASPCKPT,UNIT=3330,VOLUME=SER=CHKPT, 

DISP=(NEW,KEEP),SPACE=(ABSTR,(42,2)),LABEL=EXPDT=99366 



Figure 2-4. Defining JES2 Data Sets 



Location: The checkpoint volume may reside on any of the direct-access devices listed in 
Figure 2-2. All shared JES2 systems must have at least one channel path to the device. 

The checkpoint data set is used frequently and is therefore important to throughput in 
shared JES2 systems. This should be considered when choosing other data sets for 
allocation on the same volume. It is strongly recommended that the RESERVE macro 
not be used for any other data set on the checkpoint volume. If necessary, the RESERVE 
macro should be used infrequently and for short periods of time. Serious degradation of 
shared JES2 throughput may result if this recommendation is ignored. 

Space Allocation: The checkpoint data set should be allocated as a single extent within 
one cylinder. JES2 uses only the first extent. Space allocation should be: 

SPACE=(ABSTR,(primary quantity ,address)) 

ABSTR 

specifies that the data set is to be placed at a specific location on the volume. 

primary quantity 

specifies the number of tracks to be allocated to the data set. 

address 

specifies the track number of the first track to be allocated. 

The first checkpoint record requires one or more tracks sufficient to hold the following 
number of bytes: 

400+3(&NUMRJE+ l)+(3(&NUMRJE)+7)/8+&NUMDA((&NUMTGV+7)/8) 

The second checkpoint record requires one or more tracks that can hold the following 
number of bytes: 

100+32*&NUMJOES 

The number of tracks for each record must be determined independently for each record 
(from the formulas and track capacity of the device type) and added to give the total 
requirement. 

Refer to Figure 2-4 for an example of defining this data set. 
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SYSLHASPACE 



SYS1 .HASPACE is the name of one or more data sets used for queuing JCL internal text, 
for queuing input data, and for saving job output and system messages for later output to 
printers and punches. 



Requirements for 
Specification 



Naming Conventions: One or more volumes may be designated as spool volumes. The 
first five characters of the volume serial number of each volume defined must be SPOOL 
or be identical to the first five characters specified in the JES2 initialization parameter 
&SPOOL. The sixth character can be any character that is valid in volume serial numbers. 
One volume must be designated as the primary spool volume. Its volume serial number 
must be SPOOL 1 or agree with the six characters specified in the &SPOOL parameter. 

Location: Spool volumes may reside on any combination of direct-access devices. JES2 
utilizes space from each spool volume ensuring balanced use of all allocated space. 

It is strongly recommended that each spool volume be entirely devoted to JES2 usage. To 
allocate other frequently used data sets on a spool volume would degrade the efficiency 
of JES2's direct-access allocation algorithm. 

For shared JES2 systems, all spool volumes must reside on devices that have at least one 
channel path to each JES2 system in the multi-access spool environment. 

Space Allocation: Each spool volume must contain a data set named SYSLHASPACE. 
JES2 uses only the first extent of this data set for spooling space. If more than one extent 
is allocated, only the first extent is used. Spool data sets must be allocated as single 
extent data sets. Use the following specification for allocating space for the spool data 
sets: 

SPACE=(ABSTR,(primary quantity ,address)) 

ABSTR 

specifies that the data set is to be placed at a specific location on the volume. 

primary quantity 

specifies the number of tracks to be allocated to the data set. 

address 

specifies the track number of the first track to be allocated. 



To allocate a spool volume, specify both primary quantity and address as integral 
multiples of the number of tracks per track group. For example, specify 
SPACE=(ABSTR,(1000,16)) if the number of tracks per group is 8. 

If other data sets must be allocated space on a spool volume, SYSLHASPACE should be 
allocated so that it contains no dead space. The following text illustrates how to do this. 

The unit of direct-access space allocation for JES2 is the track group. The number of 
tracks in a track group is obtained by dividing the total number, of tracks on a volume by 
the value specified in the JES2 initialization parameter &NUMTGV (the number of track 
groups per volume). The number of tracks for a 2314 volume is 4000 (regardless of the 
size the SYSLHASPACE data set). If the value of &NUMTGV is set to 500, the number 
of tracks per track group is 4000/500 or 8 tracks per track group. JES2 uses only those 
track groups that fall completely within the SYSLHASPACE space allocation. 

Refer to Figure 2-4 for an example of defining this data set. 



Procedures for Installing JES2 



The following is a list of procedures that should be followed to install JES2. 

1 . On the console typewriter, enter the command 
$p rdr n 

where n is the identification number of the card reader. 

2. Enter the command 
s jes2gen 

3. The following messages will be written on the console typewriter: 

$HASP373 JES2GEN STARTED 
GENIN ALLOCATED TO xxx 

where xxx is the unit address of the card reader. 

4. Ready the JES2 update card deck and place it in the card reader. 

5. The following message is written on the console typewriter: 
$HASP900 ENTER CARDS, UPDATE, OR END 

If the response "cards" is used, the first card in the deck must be an "UPDATE" 
control card. If the response "update" is used, the card deck should begin with the 
first IEBUPDTE control card. If there are no source updates to apply, the response 
should be "end". 

Note: There are currently no generation options supported. 

7. When JES2GEN and Stage II of system generation have been completed, the object 
modules from SYS1.HASPOBJ can be link-edited into SYS1.LINKLIB and 
SYS1.LPALIB by entering the following command: 

sjes2bld,linkvol=vo/ser,lpavol=vo/ser 

where volser is the volume serial numbers of the volumes containing SYS1.LINKLIB 
and SYS1.LPALIB, respectively. If these values are not specified, the system 
residence volume is assumed. 

Changing JES2 Program Source Modules 

If changes are to be made to the JES2 program source modules, you must specify these 
changes in control statements. This section discusses the rules for coding the control 
cards. 

JES2 Update Source modules in SYS1.HASPSRC may be updated by cards punched according to 

Control Cards formats acceptable to the IEBUPDTE utility program. This method is used to apply your 

own modifications to JES2. Updates are placed immediately following a card with 

UPDATE punched in columns 1 through 6. 

All IEBUPDTE control cards, except the ./ALIAS statement, can be used to update JES2 
source modules when using the JESIIGEN utility program. The ./NUMBER statement is 
accepted, but it is ignored. The ./ADD, ./CHANGE, ./DELETE, ./ENDUP, ./REPL, and 
./REPRO statements are accepted, but only the NAME, SEQ1, and SEQ2 keywords are 
interpreted, where appropriate. Other keywords are ignored and may be omitted. 

The update cards immediately following the control cards replace existing source card 
images in SYS 1 .HASPSRC (if columns 73 through 80 match an existing card image in the 
named module) or are inserted between existing source card images, according to 
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Processing 



ascending collating sequence based on columns 73 through 80. Cards that are blank in 
columns 73 through 80 are inserted immediately following the last modification card 
image that is in ascending collating sequence. Update cards that do not maintain an 
ascending collating sequence or are not blank will terminate the JES2 generation with an 
update error. 

All modifications that apply to one source module must be integrated, in ascending 
sequence number order, into a single deck, beginning with an IEBUPDTE function 
statement (usually a CHANGE statement) naming the module. If more than one module 
is updated, the decks must be placed together so that the module names on the function 
statement cards are in ascending collating sequence in the same order as the source 
modules listed in Figure 2-1. 

The last update card must be followed by a ./ENDUP control card, a /* delimiter card, or 
a machine-generated end-of-file. Figure 2-5 shows a composite deck of JES2 source 
updates in correct order. 

The format of IEBUPDTE control cards is detailed in OS/VS Utilities. 



The JES2 generation jobs are executed in a sequential order using a single initiator. The 
job control language required to execute the programs is a cataloged procedure in the 
generating system's SYS1.PROCLIB. During JES2 generation, the following occurs: 

1. The JESIIGEN utility program is executed. This utility program reads in -source 
modules from the SYS1.AOSH2 distribution library and places them in the 
SYS1.HASPSRC data set. It then reads the JES2 update cards, if any, and applies the 
changes to the source modules in SYS1.HASPSRC. 



Columns 

1 73 80 

//HASPGEN JOB 

//GEN EXEC HASPGEN 

//HASPGEN.OPTIONS DD * 

UPDATE (END if no source updates follow) 

./ CHANGE NAME=HASPMISC 



./ 

/* 

//HASPNUC 

//NUC 

//HASPINIT 

//UNIT 



modifications to module HASPMISC) 



CHANGE NAME=HASPRTAM 



modifications to module HASPRTAM) 



ENDUP 

JOB 

EXEC HASPASM,MODULE=HASPNUC 

JOB 

EXEC HASPASM,MODULE=HASPINIT 



nnnnnnnn 



nnnnnnnn 



Figure 2-5. Sample Batch JES2 Generation Jobs with Update Deck 
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2. The source code in SYS1.HASPSRC is assembled. The object modules from these 
assemblies are placed in the SYS1.HASPOBJ data set. 

3. The object modules from SYS1.HASPOBJ are link-edited into either SYS1.LINKLIB 
orSYSl.LPALIB. 

The success of the generation process is determined, and a completion code is returned as 
follows: 



Decimal 

Completion 

Code 


24 



Meaning 

No errors, were detected and all members of the SYS1.HASPSRC 
data set were successfully constructed. 

An unrecoverable error, which prohibited the successful 
construction of the SYS1.HASPSRC data set, was detected. An 
accompanying message gives further indication of the error. This 
completion code without any message indicates a JES2 parameter 
error (for example, the END card was omitted). 



Refer to OS '/VS Message Library: VS2 System Codes and OS/VS Message Library: VS2 
System Messages for a more detailed discussion of the completion codes and messages 
that are returned by the system. 



Output 



The output from the JES2 generation is the job entry subsystem. In addition, the 
JESHGEN utility prints an information listing. Also produced is a listing of each assembly 
and link-edit. 



Modifying JES2 



A partial JES2 generation may be done under a production batch system if only a small 
number of modules need to be modified (a complete JES2 generation may also be done 
using this method). Execution of a partial JES2 generation invokes only the JESIIGEN 
utility, which performs the source updating. This utility merges member HASPPTF 
(located in SYS1.AOSH2) into SYS1.HASPSRC before any assemblies are done. You 
must specify the modules that are to be reassembled and link-edited using JES2 cataloged 
procedures. Figure 2-5 shows an example of the jobs that need to be executed. 

If source modules are updated from a previous generation using update cards, the updated 
module must be reassembled. When you are not sure whether a reassembly is 
necessary— for example, if a source module in SYS1.HASPSRC other than one of the 
twelve assembly modules is updated— then all twelve modules must be reassembled. 

HASPDOC is not an executable JES2 module; rather, it is a documentation module of all 
JES2 control blocks. Therefore, it should be reassembled periodically to provide current 
control block documentation. 

To perform a partial JES2 generation, do the following: 

1. Mount the volumes containing the SYS1.AOSH1 and SYS1.AOSH2 distribution 
libraries and the SYS1.HASPSRC and SYS1.HASPOBJ data sets. 

2. Scratch the SYS1.HASPSRC data set and reallocate it. 

3. Place the JES2 update deck, if any, in the card reader and execute the HASPGEN 
procedure. 
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4. Execute the HASP ASM procedure to reassemble the modules into SYS1.HASPOBJ 
(see Figure 2-5). If all of the modules are to be reassembled, SYS1.HASPOBJ should 
be scratched and space should be reallocated prior to executing the assemblies. 

5. Execute the HASPLNK or HASPLPA procedures (or both) to link-edit the modules 
into either SYS 1 XINKLIB or SYS 1 XPALIB. 
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CHAPTER 3. JES2 INITIALIZATION 



JES2 initialization is the series of operations JES2 performs each time it is started in 
order to ready itself for job processing. During each initialization, JES2: 

• Loads the JES2 routines and initializes buffer queues 

• Locates and initializes all external devices and spool volumes 

• Validates a multi-access spool configuration 

• Initializes internal readers and logical initiators 

• Initializes internal tables and the subsystem interface 

The way JES2 initializes depends upon a set of initialization options that are processed 
when JES2 is started and a set of initialization parameters (defined as a data set in the 
JES2 procedure) that JES2 reads during its execution. The initialization options define 
how JES2 will perform initialization by specifying: 

• JES2 cold start or warm start 

• The data set containing the initialization parameters 

• A printout of the initialization data set 

• Forced formatting of the spool volumes 

• Automatic or operator-controlled start of JES2 processing 

The initialization parameters define which of the JES2 functions and device defaults are 
to be overridden. The parameters specify: 

• Logical initiator characteristics 

• Internal reader characteristics 

• Local and remote device characteristics 

• Default job and SYSOUT class characteristics 

• Multi-access spool control parameters 

• Changes to certain JES2 default parameter values 

You control how JES2 schedules jobs by the way you specify these options and 
parameters during JES2 initialization. Furthermore, you can respecify these options and 
parameters to reflect changes in the system's configuration and workload each time JES2 
is started. 

This chapter explains how to specify the options and parameters and how JES2 performs 
initialization under different starting conditions. 



How to Control JES2 Initialization 



JES2 initialization is performed after JES2 is started and before JES2 begins to process 
jobs. To control how JES2 initializes, you can do three things: 

• Create a data set containing the initialization parameters 

• Update the JES2 procedure to include definitions of the initialization data set and 
(optionally) other procedure libraries 

• Specify the initialization options 

Directions for these steps are contained in the following sections. 
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Creating an Initializa- An initialization data set contains the initialization parameters and, optionally, JES2 
tion Data Set control statements and operator commands. All of the parameters, control statements, 

and commands are coded on punched cards and entered as a data set into a system library 

by one of the IBM utility programs, such as IEBUPDTE. 

The initialization parameters allow you to specify the functions and device characteristics 
JES2 uses during its execution. The parameters and their functions are summarized in 
Figure 3-1 and they are fully described at the end of this chapter. HASP users will 
recognize many of these parameters as former HASP generation parameters. Users of 
versions of JES2 previous to JES2 Release 4.0 will recognize that all JES2 generation 
parameters have been moved to initialization or have been eliminated. The purpose of 
moving these parameters from the generation process to the initialization process is to 
give the installation more flexibility in controlling the system. 

The RMTnnn initialization parameters may not be required for local single system 
configurations. However, if you have specified RMT generations for remote terminals, 
you will have to code the RMTnnn initialization parameters to initialize these terminals. 
If you choose not to specify the parameters for local devices and JES2 functions, JES2 
provides default values. For instance, for local devices, JES2 checks all the unit control 
blocks (UCBs) built during system generation and, when initialization is completed, starts 
all physically connected devices that are ready. By specifying initialization parameters for 
all local devices, you can choose, for example, to drain the devices you will not want to 
use right away. 

For a multi-acces spool configuration, you must define an initialization data set For each 
system in the configuration. Each data set must include the system identifers (specified 
by the Sn initialization parameter) of all systems in the configuration. In addition, the 
initialization data set for each system should be set up so that each unit-record device 
name is assigned to only one physical device in the multi-access spool configuration. For 
example, if three readers are generated for a configuration of three systems, they should 
be initialized as READER1, READER2, and READER3 among the data sets and not as 
READER1 in each system's data set. Then the readers can easily be reassigned in 
subsequent system initializations. (A device that is not to be attached to a particular 
system can be forced into an undefined status by assigning it a nonexistent unit address, 
such as UNIT=FFF.) 

In addition to the initialization parameters, an initialization data set can also contain: 

• Patch and AMASPZAP statements 

• JES2 operator commands 

• JES2 initialization control statements 

The operator commands and the Patch, AMASPZAP, and initialization control statements 
can be mixed among the initialization parameters without any special coding require- 
ments. 

Patch and AMASPZAP statements can be used to make minor and temporary 
modifications to the JES2 source code for the duration of an IPL by directly replacing 
the changed code. Directions for using these statements are provided in Chapter 6. JES2 
processes the Patch and AMASPZAP statements as they are read within the initialization 
data set. 
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JES2 Initialization Parameters 



Parameter 



Function 



&BSPACE specifies the character that will be interpreted as the machine-defined 

backspace character, X'1 6'. 

&BSVBOPT specifies whether to recognize an EM (end of media) punch in cards 

transmitted nontransparently by a 2780. 

&BUFSIZE specifies the size, in bytes, of each JES2 buffer. 

&CCOMCHR specifies the character that will be used to identify JES2 commands from 

local consoles. 

&CHKPT specifies the serial number of the volume containing the JES2 checkpoint 

data set SYS1 .HASPCKPT. 

&CKPTIME specifies, in seconds, the interval at which certain checkpoints of JES2 

information will be taken for warm start. 

&DEBUG specifies whether debugging information is to be gathered by JES2 during 

its operation. 

&DELAYTM specifies, in microseconds, the delay time RTAM is to apply when transmitting 

to certain System/360 Model 20s and 2922s. 

DESTID specifies a user-defined name for a JES2 route code. 

&DMNDSET specifies whether inline printer setup will be allowed for data sets whose 

SYSOUT class matches the job message class. 

&ESTIME specifies, in minutes, the default estimated execution time for a job. 

&ESTLNCT specifies, in thousands of lines, the default estimated print line output for a 

job. 

&ESTPUN specifies, in number of cards, the default estimated punch card output for a 

job. 

Innnn specifies the characteristics of a JES2 logical initiator. 

INTRDR specifies the characteristics of the internal readers. 

&JCOPYLM specifies the maximum number of job output copies that can be requested 

by means of a JOB or /*JOBPARM card. 

&LINECT specifies the maximum number of lines of a job's printed output to be 

printed per page. 

LINEnnn specifies the characteristics of a teleprocessing line for a BSC or SNA remote 

work station. 

LOGON 1 identifies JES2 as an application program to VTAM. 

&MAXCLAS specifies the maximum number of job classes that may be handled by a JES2 

logical initiator. 

&MAXDORM specifies, in hundredths of a second, the maximum time a member of a 

multi-access spool configuration may refrain from attempting to access the 
shared queues. 

&MAXJOBS specifies the maximum number of jobs that can be in the JES2 job queue at 

a given time. 

&MAXPART specifies the number of JES2 logical initiators to be defined. 

Figure 3-1 (Part 1 of 4). The JES2 Initialization Parameters and Their Functions 
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JES2 Initialization Parameters 



Parameter 



Function 



&MIN0ORM specifies, in hundredths of a second, the minimum time a member of a 

multi-access spool configuration must wait after releasing control of the 
shared queues before again attempting to access them. 

&MINHOLD specifies, in hundredths of a second, the minimum time a member of a 

multi-access spool configuration must maintain control of the shared queues 
after accessing them. 

&MINJOES specifies the minimum number of job output elements that are to be 

reserved for use in satisfying $1 commands. 

&MLBFSIZ specifies, in bytes, the size of each JES2 MULTI-LEAVING buffer. 

&MSGID specifies whether the 8-character message identifier (HASPnnnb) is included 

with each JES2 operator message. 

&NIPFCB specifies the name of the forms control buffer image that JES2 initially loads 

into every 3800 printer. 

&NIPUCS specifies the name of the character arrangement table that JES2 initially 

loads into every 3800 printer. 

&NOPRCCW specifies the maximum number of channel command words per channel 

program for local impact printers. 

&NOPUCCW specifies the maximum number of channel command words per channel 

program for local punches. 

&NUMACE specifies the number of automatic commands that can be concurrently 

active in JES2. 

&NUMBUF specifies the number of JES2 buffers to be created. 

&NUMCLAS specifies the maximum number of classes for which a printer or punch may 

be simultaneously started. 

&IMUMCMBS specifies the number of JES2 console message buffers to be created. 

&NUMDA specifies the maximum number of direct-access volumes that can be mounted 

concurrently as spool volumes. 

&NUMINRS specifies the number of internal readers to be supported. 

&NUMJOES specifies the number of job output elements to be generated for printers and 

punches. 

&NUMLNES specifies the number of communication lines to be defined. 

&NUMPRTS specifies the maximum number of local printers that JES2 can use. 

&NUMPUNS specifies the maximum number of local punches that JES2 can use. 

&NUMRDRS specifies the maximum number of local card readers that JES2 can use. 

&NUMRJE specifies the number of remote terminal definitions JES2 will use. 

&NUMSMFB specifies the number of SMF buffers to be provided in JES2. 

&NUMTGV specifies the number of track groups into which each spool volume is divided. 

&NUMTPBF specifies the number of buffers to be provided for RJE. 

&OUTPOPT specifies the action to be taken when a job exceeds its estimated print or 

punch output. 

&OUTXS specifies, in number of print lines or punched cards, the interval at which 

"line/card exceeded" messages will be issued. 

Figure 3-1 (Part 2 of 4). The JES2 Initialization Parameters and Their Functions 
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JES2 Initialization Parameters 



Parameter 



Function 



&PRIDCT specifies the number of lines to appear on each JES2 job separator page for 

local printers. 

&PRIHIGH specifies the upper priority limit to be associated with the JES2 priority 

aging feature. 

&PRILOW specifies the lower priority limit to be associated with the JES2 priority 

aging feature. 

PRINTERnn specifies the characteristics of a local printer. 

&PRIOOPT specifies whether the JES2 /*PRIORITY control statement is supported. 

&PR IRATE specifies the number of time periods into which a 24-hour day is to be 

divided for use in incrementing a job's priority by the JES2 priority aging 
feature. 

&PRTBOPT specifies whether double buffering is to be used for local printers. 

&PRTFCB specifies the forms buffer image or carriage control tape that JES2 initially 

assumes is mounted on every impact printer. 

&PRTRANS specifies whether print lines destined to printers other than 321 1 or 3800 

printers are to be translated. 

&PRTUCS specifies the name of the print chain or print train that JES2 initially assumes 

is mounted on every impact printer. 

&PRTYOPT specifies whether the priority specification on the JOB statement is supported. 

&PUNBOPT specifies whether double buffering is to be used for local card punches. 

PUNCHnn specifies the characteristics of a local card punch. 

&RCOMCHR specifies the character that will be used to identify JES2 commands from a 

local or remote card reader. 

&RDROPSL specifies a parameter field to be passed to the OS/VS2 converter for TSO 

logons. 

&RDROPST specifies a parameter field to be passed to the OS/VS2 converter for console- 

started tasks. 

&RDROPSU specifies a parameter field to be passed to the OS/VS2 converter for batch 

(background) jobs. 

READERnn specifies the characteristics of a local card reader. 

&RECINCR specifies the record alternation value to be used in spool record allocation. 

&RJOBOPT specifies the type of scan that JES2 is to perform on JOB cards. 

RMTnnn specifies the characteristics of a BSC or SNA remote terminal. 

Rnnn.PRm specifies the characteristics of a remote printer. 

Rnnn.PUm specifies the characteristics of a remote punch. 

Rnnn.RDm specifies the characteristics of a remote card reader. 

&RPRBOPT specifies whether double buffering is to be used for remote printers. 

&RPRI(n) specifies the job scheduling priority to be associated with the corresponding 

&RPRT(n) parameter. 

&RPRT(n) specifies the execution time to be associated with the corresponding &RPRI(n) 

parameter. 



Figure 3-1 (Part 3 of 4). The JES2 Initialization Parameters and Their Functions 
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JES2 Initialization Parameters 



Parameter 



Function 



&RPS specifies whether rotational position sensing (RPS) is to be included in channel 

programs directed to direct-access devices with the RPS feature. 

&RPUBOPT specifies whether double buffering is to be used for remote card punches. 

&SID specifies a system ID to be used in place of the ID provided by SMF. 

Sn specifies the characteristics of a member of a multi-access spool configuration. 

&SPOLMSG specifies the number of spool records to be reserved for operator messages and 

JES2 messages for each remote terminal. 

&SPOOL specifies the volume serial number of the primary JES2 spool volume. 

&STC,&TSU,&x specifies the characteristics of a job class. 

STCMCLAS specifies the message clags for all started tasks. 

&STDFORM specifies the default output forms ID and the default initial printer and card 

punch setup. 

&SYNCTOL specifies, in seconds, the time interval a member of a multi-access spool con- 

figuration may remain dormant before another member of the configuration 
will consider it inactive. 

&TCELSIZ specifies the number of spool records in a track cell. 

&TGWARN specifies the threshold percentage use of spool space that causes JES2 to 

issue a spool utilization message. 

&TIMEOPT specifies whether JES2 should monitor jobs for the elapse of estimated execu- 

tion time. 

&TIMEXS specifies, in minutes, the interval at which JES2 will issue messages relating to 

the elapse of a job's estimated execution time. 

&TPBFSIZ specifies, in bytes, the size of each JES2 teleprocessing buffer. 

&TPIDCT specifies the number of lines to appear on each JES2 job separator page for 

remote printers. 

TSUMCLAS specifies the message class for all time-sharing foreground jobs. 

&WAITIME specifies, in seconds, how long RTAM should wait after processing an input 

stream or a job's output stream to allow the remote operator to alter the 
normal sequence of RJE operations. 

&WARNTIM specifies, in hundredths of a second, the time interval from the first denied 

request for access to the shared queues of a member of a multi-access spool 
configuration to the time that configuration will assume the member 
controlling the queues to be down. 

$$x specifies the characteristics of a SYSOUT class. 

&XBATCH specifies whether the JES2 execution batch scheduling feature is to be 

activated. 

&XBATCHN specifies the first five characters of the name of each OS/VS2 procedure that 

JES2 will start to activate an execution batch scheduling monitor program. 

&XLIN(n) specifies the output record counts to be associated with the corresponding 

&XPRI(n) parameter. 

&XPRI(n) specifies the output processing priority of a job to be associated with the 

corresponding &XLIN(n) parameter. 



Figure 3-1 (Part 4 of 4). The JES2 Initialization Parameters and Their Functions 
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JES2 operator commands can be used to control the initial status of devices. For- 
instance, operator commands can be used to start RJE lines during initialization. (RJE 
lines, unlike other devices, cannot be started automatically by an initialization 
parameter.) Or, the $VS operator command can be used to enter VS commands such as 
those to VARY devices on and off line before JES2 starts processing. JES2 operator 
commands are described in the Operator's Library: OS/VS2 JES2 Commands. 

The number of operator commands you can specify in an initialization data set is 
essentially unlimited. During initialization, JES2 stores the operator commands in 
temporary message buffers. Then, when initialization is completed, JES2 processes the 
commands. If the number of commands entered is greater than the number of buffers 
(the &NUMCMBS parameter indicates the number of buffers to be created), the 
commands entered after all the buffers have been used are ignored. 

To ensure that operator commands are completely processed before JES2 starts 
processing jobs, you should use the REQ initialization option which lets the operator 
start JES2 processing. Or, the $S command can be included as the last operator command 
in the initialization data set to eliminate the need for operator intervention. 

JES2 initialization control statements can be used to format the listing of the data set 
when it is printed during initialization. There are three of these control statements: 

NOLIST, which tells JES2 to stop or discontinue listing of the data set from this point on 

LIST, which tells JES2 to resume listing of the data set from this point on 

*, which tells JES2 this is a comment statement 

LIST and NOLIST provide a convenient way to protect portions of your data set (such as 
passwords) during printout of the data set. Comment (*) statements can be used to 
provide spacing and headings within the data set. All three types of statements are 
processed at the point where they occur in the data set. They are ignored if you specify 
the NOLIST initialization option. 

The operator commands and the Patch, AMASPZAP, and initialization control statements 
can be mixed among the initialization parameters without any special coding require- 
ments. Figure 3-2 shows an example of an initialization data set that contains operator 
commands and initialization control statements. (The initialization parameters are 
described later in this chapter.) 

After you have coded your data set, it should be transferred to a direct-access volume by 
using one of the IBM utility programs, such as IEBUPDTE. The data set should be 
entered as a member of a blocked system library such as SYS 1 .PROCLIB or as a member 
of a blocked user library. This member must then be defined in the JES2 procedure so 
that when JES2 is executed, it can locate and read the initialization data set. Directions 
for updating the JES2 procedure are contained in the following section. 

Updating the JES2 The basic JES2 procedure (Figure 3-3) provided with the MVS system contains an EXEC 

Procedure statement and three data definition (DD) statements named PROC00, HASPLIST, and 

HASPPARM. PROC00 defines a default procedure library to be used for converting the 
JCL of user jobs, time-sharing logons, and system tasks. HASPLIST defines what is 
normally a dummy output data set. HASPPARM defines a member in SYS 1 .PARMLIB 
that contains a null initialization data set (see Figure 3-4). 
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SAMPLE JES2 PARAMETER LIBRARY LISTING 

* 

&CHKPT=IPLVOL 

READER1 UN1T=00C 

READER2 UNIT=00B,PRIOLIM=9,CLASS=X,AUTH=7,3,PRLCL 7,AUTH=PRDEST=3,PRLCL 

&NUMPRTS=4 

PRINTER1 UNIT=002,CLASS=AJH,UCS=P11 

PRINTER2 UNIT=00E,CLASS=AJH,UCS=PN,AUTO 

PRINTER3 UNIT=00F,CLASS=A,ROUTECDE=3,UCS=HN 

PRINTER4 UNIT=018,CLASS=NI,MARK,NOBURST,DSPLTCEL 

PUNCH1 UNIT=OOD,PAUSE 

1 INTRDR PRIOLIM=9 f AUTH=7 

11 CLASS*AFJKE INITIATOR 1 

12 CLASS=BCDEF INITIATOR 2 

13 CLASS=DEFGH INITIATOR 3 

14 CLASS=XKH INITIATOR 4 

15 CLASS=JKEBF INITIATOR 5 

16 DRAIN SPARE INITIATOR 

17 DRAIN SPARE INITIATOR 

18 DRAIN SPARE INITIATOR 

&STC NOJOURN,NOLOG,NOOUTPUT STARTED TASK DEFINITIONS 

&TSU CONVPARM=00014400005030E0001 1 

&S PROCLIB=03,HOLD SYSTEM PROGRAMMER CLASS 

&X PERFORM=3,XBATCH EXECUTION BATCHING CLASS 

$$H HOLD SYSOUT CLASS HELD FOR OUTPUT PROCESS 

$$N TRKCEL 

$$X DUMMY THROWA WAY CLASS 

* 

RJE INITIALIZATION PARAMETERS 

* 

LINE1 UNIT=040,FDUPLEX,TRANSP 

LINE2 UNIT=041,TRANSP,PASSWORD=SECRET 

LINE3 UNIT=042,TRANSP,PASSWORD=SECRET 

LINE4 UNIT=043,TRANSP,PASSWORD=SECRET 

LINE5 UNIT=044,TRANSP,PASSWORD=SECRET 

LINE6 UNIT=SNA 

LINE7 UNIT=SNA,PASSWORD=LINE4PW 

RMT1 3780,LINE=1,NUMPU=1,TRANSP,ABUFEX,COMP 

2 R1.PR1 PRWIDTH=144 

RMT2 2922,NUMPU=1,CONSOLE,MULTI,TRANSP 

R2.PR1 PRWIDTH=132,AUTO 

RMT3 S370,NUMPR=2,CONSOLE,MULTI,TRANSP 

R3.PR1 PRWIDTH=150,FCBLOAD 

R3.PR2 PRWIDTH=132 

RMT4 1130,CONSOLE,MULTI,NUMPU=1 

R4.PR1 AUTO 

R4.PU1 DRAIN 

RMT5 SYSTEM3,NUMRD=3,NUMPU=2,CONSOLE,MULTI 

R5.PR1 PRWIDTH=132,AUTO 

RMT6 2780,NUMPU=1,TRANSP,MRF,TABS 

R6.PR1 PRWIDTH=144 

RMT7 LUTYPE1,ROUTECDE=10,BUFSIZE=512,DISCNVT=8000,NUMPU=1,COMP 

RMT8 LUTYPE1,LINE=6,BUFSIZE=256,NUMPU=1 

3 NOLIST 

ft£MOTE PASSWORDS 

1 All JES2 internal readers are defined by one INTRDR parameter. 

2 Parameters that specify remote devices do not have to follow their associated RMTnnn 
parameters; they may be put anywhere in the card deck. 

3 Shaded area will not appear on a printout. 

Figure 3-2 (Part 1 of 2). Example of a JES2 Initialization Data Set 
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LIST 

# 

* JES2 PARAMETER OVERRIDES 

* 

&NUMBUF=40 
&TCELSIZ=6 
&NIPUCS=GF12 
TSUMCLAS=H 



MULTI-ACCESS SPOOL CONFIGURATION PARAMETERS 



51 SID=L158 

52 SID=K168 



OPERATOR COMMANDS 



$S LNE1 
$S LNE2 
$S LNE3 
$S LNE4 
$S LNE5 
6 $VS/V(234,235,236 f 237),OFFLINE' 



END OF JES2 PARAMETER LIBRARY LISTING 



Parameters can be coded more than once to incorporate additional subparameters. 
(When the same subparameter is repeated for a parameter, the value specified last is 
the one that is used.) 

Assuming this initialization data set is for a system whose SMF identifier is L158. 
Both of these parameters must also be included in the initialization data set for the 
system whose identifier is K168. 

An operator command is used to ensure that these devices are varied offline regardless 
of their initial status. 



Figure 3-2 (Part 2 of 2). Example of a JES2 Initialization Data Set 



//JES2 PROC MEMBER=JES2PARM 

//IEFPROC EXEC PGM=HASJES20,DPRTY=(15,15),TIME=1440 

//PROC00 DD DSN=SYS1.PROCLIB,DISP=SHR 

//HASPPARM DD DSN=SYS1.PARMLIB(&MEMBER),DISP=SHR 

//HASPLIST DDDDNAME=IEFRDER 



Figure 3-3. The Basic JES2 Procedure 
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JES2 INITIALIZATION DATA SET 



JES2 INITIALIZATION PARAMETERS, CONTROL STATEMENTS 
AND OPERATOR COMMANDS SHOULD BE MERGED WITH THIS 
MEMBER. 

SYSTEM PERFORMANCE MAY BE IMPROVED BY MOVING THIS 
MEMBER TO A BLOCKED SYSTEM LIBRARY SUCH AS SYS1.PROCLIB 
OR BLOCKED USER LIBRARY AND CHANGING THE HASPPARM 
DD STATEMENT IN THE JES2 PROCEDURE TO REFLECT 
THIS CHANGE. 



Figure 3-4. The Distributed HASPPARM Initialization Data Set 

The JES2 procedure can be updated by entering update cards with the IBM IEBUPDTE 
utility program. You can add DD statements to the JES2 procedure to define: 

• Other cataloged procedure libraries that are associated with job classes by the &STC, 
&TSU, and &x initialization parameters or by the JOBPARM control statement. Each 
library should be defined by a PROCnn DD statement. For instance, to specify a 
special library for TSO logons, code PROCLIB=nn (where nn corresponds to the 
associated PROCnn DD statement) in the &TSU initialization parameter. 

• One or more initialization data sets that define different operating conditions and 
types of workloads. See Figure 3-5 for an example of an updated JES2 procedure. 

If you wish, you can use the HASPPARM DD statement to define an initialization data 
set by replacing the IBM-supplied null data set. Alternatively, the initialization data set 
may be created separately and defined by its own DD statement in the procedure* 

To make the HASPLIST DD statement effective, IEFRDER must be defined with the 
address of an output device in your system. This permits the HASPLIST data set to be 
written to that output device for a listing of the initialization data set. 

DD statements added to the JES2 procedure must refer to data sets that are cataloged in 
the master catalog or that are specified by volume serial number. You cannot add DD * 
or DD DATA statements to the JES2 procedure. If SYSOUT DD statements are added, 
they will be ignored. 

Specifying the Initial- When JES2 is started, it uses five initialization options to determine how it will perform 
ization Options the current initialization. The initialization options, which are described in Figure 3-6, 

may be specified in either of two ways: as parameters on the EXEC statement in the 

JES2 procedure or as options specified at the console. 

If the options are not specified on the EXEC statement,. JES2 requests them from the 
operator by issuing the following WTOR message: 

$HASP426 SPECIFY OPTIONS-HASP-II, VERSION JES2 4.0 

The operator then enters the options using the standard reply format as described in 
Operator's Library: OS/VS2 JES2 Commands. Options may be entered in uppercase or 
lowercase and must be separated by commas. If conflicting options (for example, WARM, 
COLD) are entered, the latter option overrides the former one. 
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//JES2 PROC M=JES2PARM,N=SYS1,L=LINKLIB,U=3330-1,V=SG3002 

//* 

//»##»*****#»**#####»####*###*##****#***##***###**######*#*##**##*###♦######»**##. 

//* 

//* EXAMPLE OF AN UPDATED JES2 PROCEDURE 

//* 

//* M=MEMBER IN SYS1.PARMLIB CONTAINING INIT DECK 

//* N=1ST INDEX OF DSNAME CONTAINING HASJES20 LOAD MODULE 

//* L=2ND INDEX OF DSNAME CONTAINING HASJES20 LOAD MODULE 

//* U=UNITNAME CONTAINING JES2 INITIALIZATION PARAMETERS 

//* V=VOLUME SERIAL NUMBER CONTAINING THE JES2 LOAD MODULE 

//* 

//* EXAMPLES: 

//• 

//* SJES2 START STANDARD JES2 PROCEDURE 

//* S JES2,00E PRODUCES A LISTING OF INIT PARMS 

//* S JES2, N=ALT,U=OOC STARTS AN ALTERNATE JES2 

//• INIT PARMS READ IN FROM CARDS 

//* S JES2,00F,M=BATCHPRM LISTS AND USES ALTERNATE INIT PARMS 

//• S JES2 STARTS STANDARD JES2 PROC 

//* — FOLLOWED BY (IN RESPONSE TO $HASP426) 

//* RXX,NOREQ,HASPPARM=SECSHIFT USED FOR SECOND SHIFT 

//* SJES2,M=SECSHIFT SAME RESULTS AS ABOVE 

//* S JES2,M=TSUPARMS USED DURING TIME-SHARING HOURS 

//* 

//* S JES2,00E,N=HASP,U=00C,PARM=(COLD,NOREQ) 

//* STARTS AN ALTERNATE VERSION OF JES2 

//* INIT PARAMETERS ARE ON CARDS 

//• INIT OPTIONS ARE COLD,NOREQ 

//* 
//**#************#**********»#*************#**********«******#*****#*#***#*******< 

//* 

//IEFPROC EXEC PGM=HASJES20, TIME=1440,DPRTY=(15,15) 

//STEPLIB DD UNIT=3330-1,VOL=SER=&V,DISP=SHR,DSN=&N..&L 

//PROC00 DD DSN=SYS1.PROCLIB,DISP=SHR 

//PROC01 DD DSN=SYS1.USERLIB,DISP=SHR 

//PROC02 DD DSN=SYS1.USERLIB,DISP=SHR 

// DD DSN=SYS1.PROCLIB,DISP=SHR 

//BATCH DD DSN=SYS1.PARMLIB(BATCHPRM),DISP=SHR 

//SECSHIFT DD DSN=SYS1.PARMLIB(SECSHIFT),DISP=SHR 

//HASPPARM DD DSN=SYS1.PARMLIB(&M),DISP=SHR,VOL=SER=&V,UNIT=&U 

//HASPLIST DD DDNAME=IEFRDER EFFECTIVE WHEN "S JES2,00E" 

Figure 3-5. Example of an Updated JES2 Procedure 



If the options are specified on the EXEC statement, JES2 suppresses the SPECIFY 
OPTIONS WTOR and completes initialization without operator intervention. The EXEC 
statement in the JES2 procedure in Figure 3-5 shows how the options can be coded as 
parameters. 

After it has accepted the options, JES2 reads the specified initialization data set. When 
initialization is completed, JES2 is ready to start processing jobs. JES2 will start 
processing automatically if you specified the NOREQ option. Otherwise, it issues the 
following message to request the operator to issue the $S command to start JES2 
processing: 

$HASP400 ENTER REQUESTS 

The operator can also respond to this message with other commands to change the initial 
status of initialized devices before JES2 starts to process. 



Chapter 3. JES2 Initialization 23 



Initialization Options 



Option 



Explanation 



(format) 
IMOFMT J 



(COLD \ 
| WARM f 



HASPPARM=ddname 
HASPPARM= HASPPARM i 




FORMAT specifies that JES2 is to format all existing spool 
volumes. If unformatted spool volumes are added, JES2 
automatically formats them whether FORMAT is specified or not. 
When FORMAT is specified, JES2 will automatically be cold 
started. 

Note: The FORMAT option is denied if this is a multi-access 
spool configuration and JES2 is processing in one or more of 
the other systems. 

Default: NOFMT specifies that JES2 is not to format existing 
spool volumes unless JES2 determines that formatting is required. 

COLD specifies that JES2 is to be cold started. All jobs in the 
system are purged and all job data on the spool volumes is 
scratched. 

Note: The COLD option is denied if this is a multi-access spool 
configuration and JES2 is processing in one or more of the other 
systems. 

Default: WARM specifies that JES2 is to be warm-started. JES2 
continues processing jobs from where they were stopped. 

Note: If the system to be warm-started is in a multi-access spool 
configuration with any other active systems, only this system is 
warm-started. If there are no other active systems, JES2 requests 
the operator to verify that no other systems are active and, when 
verified, proceeds to warm start all jobs. 

NOR EQ specifies that the $HASP400 ENTER REQUESTS 
message is to be suppressed and that JES2 is to automatically 
start processing when initialization is completed. 

Default: REQ specifies that the $HASP400 ENTER REQUESTS 
message is to be written at the console. This message allows the 
operator to start JES2 processing with the $S command. 

NOLIST specifies that JES2 is not to print the contents of the 
initialization data set or any error flags that occur during 
initialization. If NOLIST is specified, any LIST control 
statements in the initialization data set are ignored. 

Default: LIST specifies that JES2 is to print all the statements 
in the initialization data set and any error flags that occur 
during initialization. (JES2 prints these statements if a printer 
is defined for that purpose when JES2 is started.) LIST does 
not print any statements that follow a NOLIST control 
statement in the initialization data set. 

ddname specifies the name of the data definition (DD) 
statement that defines the data set containing the initialization 
parameters that JES2 is to use for this initialization. 

Default: HASPPARM specifies that JES2 is to initialize using 
the initialization parameters in the data set defined by the 
HASPPARM DD statement in the JES2 procedure. 

NONE, U, N, or the null character specifies that JES2 is to 
use all the default initialization options. 



Figure 3-6. The JES2 Initialization Options 
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How JES2 Performs Initialization 

JES2 performs an initialization the first time it is started (as part of the IPL procedure) 
and every time it is restarted after a normal system shutdown or after a system failure. In 
a multi-access spool configuration, JES2 must be started and initialized in each system in 
the configuration. The way JES2 performs initialization during these start situations is 
described below. 

Starting JES2 for JES2 is automatically started by the JES2 procedure (refer to Figure 3-3) in 

the First Time SYS1.PROCLIB. The START JES2 command is automatically placed in MSTRJCL 

during system generation. If the user wants the option of manually starting JES2, the 

MSTRJCL should be changed as follows using AMASPZAP: 
NAME MSTRJCL (SYSl .LINKLIB) 

VER 0320 61614bE2,E3Clb9E3,40DlC5E2F2 

REP 0320 61614040,40404040,4040404040 

It is necessary to write blanks (X'40's) to overlay the characters "START" of the 
//START JES2 command, making it a null card. When MSTRJCL is changed, JES2 
parameters can then be entered on an operator-issued START command that must be 
issued before MVS processing can occur. 

As soon as JES2 is started, it issues the SPECIFY OPTIONS WTOR. The operator should 
specify the COLD (or FORMAT) option. If COLD (or FORMAT) is not specified, JES2 
will issue the following messages: 

$HASP434 WARM START DENIED-INVALID CHECKPOINT RECORD 

$HASP420 PERM I/O ERROR READING JES2 CKPT 

$HASP428 CORRECT THE ABOVE PROBLEMS AND RESTART JES2 

You will have to restart JES2 and then specify COLD (or FORMAT) in response to the 
SPECIFY OPTIONS WTOR. 

JES2 initializes its functions and devices according to the default values of the 
initialization parameters (since HASPPARM points to a null initialization data set). When 
initialization is completed, JES2 can start processing jobs. Your first job can be the utility 
programs that create your initialization data set and update the JES2 procedure. Before 
you can use your data set, you must stop and restart JES2 with the name of the data set 
specified as an initialization option. The way to do this is described in the section, 
"Restarting JES2 after an Orderly Shutdown." 

Note: // the primary JES2 spool volume (specified by the &SPOOL initialization 
parameter) is not mounted and ready when JES2 is started, JES2 will inform the operator 
that the spool volume must be mounted and will then terminate. The volume cannot be 
mounted, however, because processing a MOUNT command requires the as-yet- 
uninitialized JES2. The only thing the operator can do is to ready the spool volume and 
IPL again. A way to avoid this situation is to include in the VA TLSTnn parmlib member 
an entry specifying the required spool volume without suppressing the mount option. 
VATLST processing will then request that the volume be mounted during the IPL 
process. An example would be: 

SPOOL 1,0,2,330 

See OS/VS2 System Programming Library: Initialization and Tuning Guide for more 
information about VATLST. 
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Starting JES2 in a 
Multi-Access Spool 
Configuration 



Whenever JES2 is started, it checks whether JES2 has already been started in another 
system that was generated with the current system as a multi-access spool configuration. 
JES2 determines this by reading the JES2 checkpoint record (SYS1.HASPCKPT) and 
checking the last time stamp recorded by each system. If a time stamp for any system is 
less than the time-of-day (TOD) clock plus the time interval specified by the JES2 
initialization parameter &SYNCTOL, JES2 is assumed to be processing in the associated 
system. In such a case, JES2 rejects the COLD (or FORMAT) option and requests the 
current system to perform a WARM start. 

If all time stamps are older than the TOD clock plus the &SYNCTOL interval, JES2 is 
assumed not to be operating in any other system. Therefore, the current system can 
either be cold started or warm started following an orderly shutdown or a system failure. 
A warm start reallocates the spool volumes that were in use in order to recover any 
direct-access space that might have been lost during a system failure. 



Restarting JES2 after 
an Orderly Shutdown 



JES2 can be stopped and restarted in a system at any time by operator commands. This 
capability allows you to (1) quiesce job processing in preparation for an orderly system 
shutdown and (2) restart JES2 to perform an initialization with a different initialization 
data set. 



For both situations, the operator first issues the $p command to drain the JES2 queues. 
When all JES2 logical initiators, printers, and punches complete their current activities 
and become inactive, JES2 notifies the operator with the following message: 

$HASP099 ALL AVAILABLE FUNCTIONS COMPLETE 

The operator can then enter the $p JES2 command which stops JES2 and removes it 
from the system. When halting the system at end-of-day or end-of-work shift, the 
operator should also enter the HALT EOD command. When the system is reloaded, JES2 
is automatically started. (The operator can, of course, specify a different initialization 
data set as an initialization option at that time by responding with HASPPARM=ddname 
when JES2 issues its SPECIFY OPTIONS message.) When JES2 completes initialization, 
it either begins to process jobs automatically or waits for the operator to enter the $S 
command in response to the ENTER REQUESTS message. 

If the operator does not halt the system after stopping JES2, JES2 can be restarted with 
the S JES2 command. As part of this START command, the initialization options can be 
specified as parameters. For example, 

S JES2,PARM='WARM,HASPPARM=RJE,NOREQ' 

When the options are specified on the START command this way, the SPECIFY 
OPTIONS WTOR is suppressed just as it is when the options are specified as parameters 
on the EXEC statement within the JES2 procedure. 

The START command can also be used to specify a printer address for the HASPLIST 
DD statement in the JES2 procedure. For example, 

SJES2,00E 

If you specify both a printer address and initialization options, the printer address must 
be specified first: 

S JES2,00E,PARM='WARM' 

You may also use the START command to start JES2 manually at IPL. (Use an 
AMASPZAP statement to remove the start command for JES2 that is contained in the 
MSTRJCL member of SYS 1 XINKLIB.) 
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Restarting JES2 after JES2 is automatically restarted in an MVS system whenever that system is re-IPLed 
a System Failure following a system failure. The WARM initialization option allows you to warm start 

JES2 and continue job processing from the point of the last checkpoint before the system 

failure. 

During a warm-start initialization, JES2 reads through its job queues and handles each job 
according to its status: 

1. Jobs in input readers are lost and must be reentered. 

2. Jobs in output (print/punch) are restarted at the last JES2 checkpoint. 

3. Jobs waiting for JES2 functions remain on the JES2 queues. 

4. Jobs in execution are either requeued for warm-start processing or are queued for 
output processing: If a job in execution was journaled, its JES2 job control table 
(JCT) is updated to indicate warm-start and the job is queued for reexecution. If a 
job in execution has no journal, it is tested to determine whether RESTART was 
indicated for the job. If RESTART was indicated, the job's JES2 JCT is updated to 
remove any warm-start indications, and the job is queued for reexecution. If 
RESTART was not indicated, the job is queued for output processing. 

Following JES2 warm-start processing, jobs queued for reexecution are again selected 
by initiators. A non-journaled job that was requeued because RESTART was 
indicated is handled as a new job. A journaled job that indicates warm-start 
processing receives special attention from an initiator. 

The initiator/terminator purges existing job tables and messages for the job, and then 
checks whether the job is authorized for warm-start processing: 

• The job must have a valid restart definition (RD=) code in the RD parameter on 
its JOB card. 



• The operator must authorize the job to be restarted. (Each eligible job is 
presented to the operator asking whether the job is to be restarted.) 

If either of these two authorizations is not made, the job is tested to determine 
whether RESTART was indicated. If it was indicated, the job's JES2 JCT is updated 
to remove any warm-start indications, and the job is queued for reexecution as a new 
job. If RESTART was not indicated, the job is queued for output processing. 
Authorized jobs are queued again for reexecution. 

Jobs can be presented to the system for warm start at any time in any order. This allows 
important jobs and system functions to be executed ahead of less important jobs 
scheduled for execution or termination. New jobs can be presented to the system and 
processed according to their priority ahead of lower-priority warm start jobs. 

When JES2 is warm started, all spool volumes (and the checkpoint data set, if different) 
that were up during the last execution of JES2 must be present and available, although it 
is not necessary that they be mounted on the same drives. If all the spool volumes are not 
up, JES2 notifies the operator. If you add a new spool volume, JES2 adds it to the list of 
spool volumes; if it is unformatted, JES2 automatically formats it. 

During warm-start initialization, JES2 lists the activity in process for each job at the time 
JES2 was stopped. Then, when the ENTER REQUESTS message is issued (unless the 
NOREQ initialization option was specified), the operator can enter requests to modify or 
delete each activity. This message also allows the operator to examine the status of 
output devices (such as UCS and FCB settings) to determine what action to take prior to 
restarting the output process, to change the status of logical initiators and devices, and to 
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modify the status of jobs on the JES2 queues. (Note that the status and activity of each 
device reverts to the specifications of the initialization parameters. If you specify 
NOREQ, JES2 begins processing each job according to the specifications of the 
initialization parameters as soon as resources to process each job become available.) 

How to Correct Initialization Errors 

During JES2 initialization, two kinds of errors can occur. The first can occur when JES2 
cannot open the data set containing the initialization parameters. This happens, for 
instance, when a DD statement is named in the HASPPARM=ddname initialization 
option, but the named DD statement is not defined in the JES2 procedure. JES2 
acknowledges the error with the following messages: 

$HASP450 OPEN FAILED FOR JES2 PARAMETER LIBRARY 

$HASP441 REPLY Y OR N TO CONTINUE INITIALIZATION 

The second message allows the operator to stop JES2 and restart it with a correctly 
defined data set. 

The second error can occur when JES2 encounters a user error in the statements in the 
initialization data set. JES2 flags each statement in error and reads the next one in the 
data set. If the data set is printed out (see Figure 3-6 for a description of the LIST 
option), each statement that is in error has an error flag printed beside it. These error 
flags and their explanations follow. 

Initialization Error CONTINUATION CARD EXPECTED 

* The statement ahead of this one was not a complete one and JES2 is expecting a 

continuation card for it. For example, a previous statement of "18 DRAIN," followed 
by an end of file would cause JES2 to expect more subparameters for this statement. 

DATA OR FORMAT ERROR 

This parameter was specified incorrectly and JES2 cannot classify the error; for 
example, specifying B instead of &B as a job class parameter. 

ILLEGAL DECIMAL VALUE 

A decimal value is required for this parameter. The value specified contains one or 
more non-decimal symbols. For example, &NUMBUF=1A2 instead of 
&NUMBUF=102. 

ILLEGAL keyword VALUE 

The value you specified for this subparameter keyword does not meet the required 
value range or specifications. For example, ROUTECDE=300 instead of 
ROUTECDE=100. 

ILLEGAL SUBSCRIPT 

The parameter subscript falls outside the valid subscript range. 

INVALID CHARACTER VALUE 

The value specified for this parameter contains one or more invalid characters. For 
example, STCMCLAS=% instead of STCMCLAS=H. 
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INVALID DEVICE NAME 

The number you specified for this device exceeds the maximum number of devices 
supported by JES2. 

INVALID HASPPARM STATEMENT 

You specified this parameter incorrectly and JES2 cannot classify the error. For 
example, READR 1 instead of READER1 . 

INVALID INITIATOR NUMBER 

The number you specified for this logical initiator either exceeds the maximum 
number JES2 allows or it contains an invalid character. 

INVALID KEYWORD keyword 

This subparameter keyword is misspelled or is not valid for this parameter. 

INVALID PARAMETER VALUE 

The value you specified for a subparameter exceeds the range limit. For example, 
PRIOINC=16 when the maximum allowed is 15. 

Note: When a parameter statement contains an error, JES2 ignores the entire 
statement and uses instead all the default values assigned for that parameter. The one 
exception to this is a parameter statement that contains a subparameter that exceeds 
its range limit. When this error occurs, JES2 honors all values specified up to the error, 
writes the error flag (INVALID PARAMETER VALUE), and ignores the remainder of 
the statement by assuming default values. 

INVALID REMOTE NUMBER 

The number specified for this remote exceeds the maximum number of remotes 
supported by JES2. 

INVALID ROUTE CODE 

The remote number specified in a subparameter exceeds the maximum number of 
remotes supported by JES2. 

INVALID SYSTEM NUMBER 

The system number specified exceeds the maximum number of members that JES2 
supports in a multi-access spool configuration. 

LIMITS ARE nnn,nnnnnnnnnn 

The number specified for this parameter falls outside the indicated range. 

VERIFICATION ERROR 

The VERIFY statement data does not match the data at the specified location. 

When all parameter statements have been read, if any statements with errors were 
encountered, JES2 issues the following messages: 

$HASP451 ERROR ON JES2 PARAMETER LIBRARY 

$HASP441 REPLY Y OR N TO CONTINUE INITIALIZATION 
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SJES2 


START JES2 




$P JES2 


STOP JES2 


(default &CCOMCHR) 


START JSS4 


START JSS4 




/P JES2 


STOP JSS4 


(&CCOMCHR=/) 



The operator's reply should be based on a careful examination of the parameter card 
error messages. If the reply is 'N', JES2 issues the following message: 

$HASP428 CORRECT THE ABOVE PROBLEMS AND RESTART JES2 . 

Alternate Subsystem Options with JES2 

MVS allows more than one subsystem to operate at a time as long as one subsystem is 
designated as the primary subsystem and others are identified as secondary subsystems. 
The system-generated primary job entry subsystem must be started and completely 
initialized before initiators can start and processing can occur. Secondary JES2s can be 
useful in testing user modifications while the primary JES2 is being used for production. 
The SCHEDULR system generation macro must name all subsystems that are allowed or 
a procedure (for example, the procedure described below) may be used to add subsystem 
names after the system generation process. 

j a <A(/\ k^ j t j s therefor possible to run more than one JES2 at a time with certain restrictions 

) 6 ■AMxJhib' applying to the secondary JES2: the secondary JES2 cannot interface with TSO or 

. ^ ^ , ,, ■ started tasks. When running more than one JES2 at a time, it is necessary to assign (by 

A vv-t- o \i ™ -v~ the &CCOMCHR initialization parameter) a unique operator command character to each 

JES2 and to have a unique spool direct access device (by means of the &SPOOL 
"\ v\& .,-, i j'f^'S J^^ t initialization parameter) for each JES2. Also, the keyword "JES2" must be used as the 

parameter to stop whatever subsystem is running regardless of the name on the START 
^Cju p<r««^-i~~v command; for example: 

<%■£ f e f) rhfiO TffC®PPT~ ^ a ** alternate subsystem support module (HASPSSSM) is to be used, it must be linked 
V SK? -> y int0 SYS1 .LPALIB under an alternate name (for example, TESTSSSM). The initialization 

deck for the subsystem using t this module must contain a statement that names the 
alternate HASPSSSM. This statement takes the form HASPSSSM=altname (for example, 
HASPSSSM=TESTSSSM). 

Before initializing with an alternate subsystem support module, however, the installation 
must specify the CLPA option as a system parameter during MVS initialization (see 
IEASYSxx under "Descriptions of Individual PARMLIB Members" in OS/VS2 System 
Programming Library: Initialization and Tuning Guide). 

/ If the alternate subsystem is placed in a libary other than SYS1.LINKLIB, the data set 
| name must be added to the IEAAPFxx member in SYS1 .PARMLIB (see the description 
\ of IEAAPFxx in OS/VS2 System Programming Library: Initialization and Tuning Guide). 

In place of the primary job entry subsystem, an alternate subsystemj^Lr^_be_ej^cjiiteAa^ 
thejgrxmary subsystem. This alternate subsystem mu^bTlirSY^lJPROCLIB and named 
on the START command. 

If the user specifies no secondary subsystem during system generation, or wants to change 
a previously-specified secondary subsystem, the JES2 subsystem names table must be 
changed. For example, assuming JES2 is the primary subsystem and the desired alternate 
JESA and HASP are the desired alternates, the required AMASPZAP statements are: 

NAME IEEVIPL IEFJESNM i^\X{^Uh) 

VER 0000 D1C5E2F2,D4E2E3D9 ' lf 

REP 0000 D1C5E2F2,D4E2E3D9,D1C5E2C1,C8C1E2D7 

30 ' 



The JES2 initialization parameter &CCOMCHR affects the identification assigned to 
JES2-initiated messages to the operator. Normally JES2-initiated messages are tagged 
with a "$" at the beginning of the text. However, the "$" character is taken, from the 
value of &CCOMCHR; therefore a different specification of this value for each subsystem 
allows the origin of the message to be identified. 



The example given below shows steps that might be used to install an alternate (or 



secondary) subsystem. . s<-/'; 



1. Run all assemblies and place the object modules into ALT.OBJLIB. 

2. Link-edit all modules except HASPSSSM and HASPDOC into ALT.LINKLIB as 
HASJES20. 

3. Link-edit HASPSSSM into SYS1 .^LIB as HASPS ALT. 

4. Add the data set name ALT.LINKLIB to IEAAPFOO. 

5. Re-IPL MVS specifying CLPA,APF=00 in response to message IEA101 A (CLPA is 
needed only once after link-editing HASPSALT). 

6. Specify options to the primary JES2 system when it enters initialization. 

7. Issue an S JESA,N=ALT,U=00C command once the primary system is active and 
after the sample procedure JESA (see below) is added to SYS1 .PROCLIB. 

The secondary (ALT) has the following initialization deck: 

&SPOOL=ALTJES 

HASPSSSM=HASPSALT 

&CCOMCHR=/ 



Specification of U=00C indicates that the initialization deck described above is to be read 
from the card reader at address 00C. 

The following is a sample procedure, JESA: 

M=JES2PARM,U=3330,L=LINKLIB,N=SYS1,V=SYSRES 

PGM=HASPJES20,DPTRY=(1 5 , 1 5),TIME= 1440 

UNIT=3330,VOL=SER=&V,DISP=SHR,DSN=«S:N..&L 

DSN=SYS1 .PROCLIB,DISP=SHR 

DSN=SYS1 .PARMLIB(&M),DISP=SHR,UNIT= &U, 

VOL=SER=&V 

DDNAME=IEFRDER 

To execute the above procedure and obtain a listing of the initialization deck for 
secondary subsystem JESA on 00E: 

S JESA,00E,N=ALT,U=00C 



//JESA 


PROC 


//IEFPROC 


EXEC 


//STEPLIB 


DD 


//PROC00 


DD 


//HASPPARM 


DD 


//HASPLIST 


DD 



Initialization Parameter Descriptions 



This section describes the JES2 initialization parameters, their functions, formats, and 
default values. The parameters are described in alphabetical order (excluding the first 
characters if & or $). The following conventions are used in the parameter descriptions: 

• Numbers and uppercase letters must be coded exactly as shown. 

• Lowercase letters represent variables for which you must substitute specific 
information or specific values. 
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• Paired parameter values or paired subparameters (for example, HOLD/NOHOLD) 
indicate that you may choose one or the other. If you specify neither, the underlined 
one will be used as the default value. 

The following syntax rules apply to the coding of most of the parameters. (Exceptions 
are contained within the parameter descriptions.) Refer to Figure 3-2 for examples of 
coded parameters. 

• A parameter is separated from its subparameters by at least one blank; subparameters 
are separated from each other by commas. 

• Any columns between 1 and 71 can contain data; column 72 is used for continuation; 
columns 73-80 are ignored. 

• Parameter statements can be continued on successive cards; continuation is indicated 
by a comma followed by a blank. (If the last subparameter on a card is not followed 
by a comma and column 72 is not blank, then the next card is considered to contain 
only comments.) 

• Subparameters cannot contain embedded blanks. The first blank terminates the 
parameter statement and the rest of the card is considered to contain comments. 

• Only one parameter can be coded per card although several subparameters can be 
coded on the same card. 

• Leading zeros cannot be used in parameter values (except as noted for specific 
parameters). This is especially true for device names: READER01 is an error; 
READER1 is correct. 

• A parameter deck is terminated by an end of file or any card that contains a /* in 
columns 1 and 2. 

• Character specifications, unless otherwise noted, can include any alphanumeric or 
national characters or the periodQ. 

Parameter cards can be put in the card deck in any order. Subparameters may also be 
specified in any order. Once a parameter or subparameter is specified, that value is used 
until that parameter or subparameter is specified again. That is, if the same parameter 
occurs more than once, or if the same subparameter occurs more than once for a 
parameter, JES2 uses the value from the last one it reads. 



&BSPACE (Console &BSPACE=nn 

Backspace Character) 



The &BSPACE parameter specifies the character that will be interpreted as the 
machine-defined backspace character X'16\ nn is the two-digit hexadecimal representa- 
tion of the EBCDIC character that will be interpreted as the machine-defined backspace 
character X'16'. When the character specified by this parameter is entered from any 
operator console, it is removed from the command text along with the previously entered 
character (if any). Characters following the backspace character are shifted left to replace 
the removed backspace characters. 

This backspace function applies to all commands entered by means of operator command 
input sources, regardless of their position in the text of the data entered. This function 
does not apply to a JES2 card reader or remote work station sources. 

Note: The character selected for the backspace function must be chosen with caution 
because it eliminates the use of that character (except as a backspace operation) in all 
commands and replies to WTORs. 
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Default: The EBCDIC character ' - * (X'5F') is used for backspace command entry on 
operator consoles. 



&BSVBOPT (2780 End of 
Media Punch Recognition 
Option) 



&BSVBOPT=YES/NO 

The &BSVBOPT parameter provides the option of recognizing an EM (end of media) 
punch in card images transmitted nontransparently by the 2780 Data Transmission 
Terminal. 



Default: NO 



&BUFSIZE (JES2 
Buffer Size) 



&BUFSIZE=nnnn 

The &BUFSIZE parameter specifies the size, a decimal number of bytes, of each JES2 
buffer. If the value specified is not a multiple of 8, it is rounded up automatically. 

Each JES2 buffer is allocated to virtual storage, so the input/output block (IOB), which is 
88 bytes, and the data area (the number of bytes in &BUFSIZE) are always contained in 
one 4K page. The maximum value, 4008, allows three records per track on a 3330. 

Lower Limit: 600 

Upper Limit: 4008 

Default: 1960, which is the maximum size that allows two buffers per page of virtual 
storage and good utilization of 2314 and 3330 track capacities (three or six records per 
track, respectively). 

Note: The maximum value, 4008, and the default value, 1960, are dependent on the 
current JES2 control block definitions. The value selected for &BUFSIZE must be at 
least the greater of 600 or (368 + &NUMDA* ((&NUMTGV + 7)/8 + 3)14*4 + 7)/ 8*8, 
where the number 368 is dependent on the current JES2 control block definitions. 



&CCOMCHR (Local 
Operator Command 
Identifier) 



&CCOMCHR=c 

The &CCOMCHR parameter specifies the character that will be used to identify JES2 
commands from local consoles. If a command from a local console begins with the 
character specified for &CCOMCHR, JES2 assumes that the command is a JES2 
command and attempts to process it. 

The value you specify should be a special character that is not used as the first character 
of any command of any other subsystem that may be operated concurrently with JES2. 
The character should be one of the following: 

( 



% 



— 1 


1 


& 


$ 


* 


) 


+ 


- 


/ 


— 


> 


? 


# 


@ 


= 



Notes: 

1. The specification must not be the character specified for the &BSPACE parameter. 
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2. If this parameter is changed to a character other than its default ($), the commands 
will vary from their documented format in Operator's Library: 0S/VS2 JES2 
Commands and the messages will vary from the format in OS/VS Message Library: 
VS2 Messages. 

Default: $ 



&CHKPT (JES2 Check- 
point Volume ID) 



&CHKPT=cccccc 

The &CHKPT parameter specifies the volume serial number of the volume that contains 
the JES2 checkpoint data set, SYS1.HASPCKPT. (Space for this data set is allocated at 
JES2 generation as described in Chapter 2.) The value you specify for &CHKPT should 
be from one to six characters that define a valid volume serial number. When this 
parameter is specified as a volume serial number other than SPOOL1 (the default for 
&SPOOL), certain messages will vary from their documentation in OS/VS Message 
Library: VS2 System Messages. 

Note: The checkpoint data set is frequently referred to, especially in multi-access spool 
configurations. Therefore, only low-usage data sets (if any) should be allocated on the 
same volume as the checkpoint data set. Otherwise, JES2 performance could be seriously 
degraded. 

Default: The volume serial number specified in the &SPOOL parameter. 



&CKPTIME (JES2 
Checkpoint Interval) 



CKPTIME=nnn 

The &CKPTIME parameter specifies, in seconds, the interval at which certain checkpoints 
of JES2 information are taken for warm start. (Checkpoints are taken, for example, when 
a job changes its status in the JES2 job queue.) The time interval specified is a maximum 
checkpoint time for a non-shared JES2 system (that is a single-member configuration). 
For JES2 systems sharing pool and checkpoint volumes, the time interval specified is used 
for print/punch checkpoints only. For these systems, a value of 120 or greater is 
recommended. 



&DEBUG (JES2 Debug 
Option) 



Lower Limit: 10 

Upper Limit: 300 (5 minutes) 

Default: 60 (1 minute) 

&DEBUG= YES/NO 

The &DEBUG parameter provides the option for JES2 to record certain JES2 events and 
to monitor certain JES2 activities. Selection of this option will degrade JES2 
performance. 

Note: The information recorded as the result of selecting this option can only be made 
available through a dump of the JES2 memory. For more information about a JES2 
dump, refer to the description of diagnostic aids in OS/VS2 MVS JES2 Logic. 

Default: NO 
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&DELAYTM (Transmis- 
sion Delay Time) 



&DELAYTM=nnnn 

The &DELAYTM parameter specifies, in microseconds, the delay time to be applied by 
RTAM when transmitting to either a MULTI-LEAVING System/360 Model 20, submodel 
2, 4, or 6, or to a 2922 remote terminal over a high-speed (19,200 baud or greater) 
teleprocessing line. This delay time avoids the possibility of certain line errors. 

If data-overrun line errors occur at the work station when the default value is used, the 
value should be increased. 

Lower Limit: 1 

Upper Limit: 9999 

Default: 100 



DESTID (Route Code 
Name) 



DESTID NAME=cccccccc 

DEST=Rnnn/Unnn/LOCAL 

The DESTID parameter specifies a user-defined name for a JES2 route code. JES2 route 
codes normally are of the form Rnnn for remote workstations (for example, R4 indicates 
SYSOUT data for remote 4), Unnn for special routed local printer or punch devices (for 
example, Ul indicates SYSOUT data for local printer or punch with route code of 1), or 
LOCAL for normal printer or punch devices with route code of 0. The user may refer to 
these JES2-defined routings in the DEST operand of the JCL data definition (DD) 
statement for /*OUTPUT, for SYSOUT data sets, in dynamic allocation of SYSOUT, or 
in the TSO OUTPUT command. The operators also refer to the JES2-defined routings in 
many JES2 operator commands. By assigning DESTID names to be equivalent to these 
routings, the users and operators may refer to the names in lieu of the names provided by 
JES2. J 

NAME=cccccccc 

specifies the name, 1 to 8 alphanumeric characters (first character alphabetic), that the 
users and operators may use to refer to the JES2-defined destinations. The characters in 
the name must not match an acceptable name that could be used in the DEST parameter. 
You should therefore refrain from using names of the form Xnnn (where X is any 
alphabetic character and nnn is a numeric value), RMnnn, or RMTnnn. 

DEST=Rnnn 

specifies the identification of the remote work station (nnn) the user or operator desires 
when the name is used. If the remote work station devices are pooled with another 
remote, the destination refers to the pool of remotes. The nnn values range from 1 to the 
maximum work station number defined to the system (refer to the description of 
&NUMRJE). 

DEST=Unnn 

specifies the special routing number to be associated with the name. The nnn values range 
from 1 to 255 and correspond to the settings specified in the local reader, printer, and 
punch route code settings. 

DEST=LOCAL 

specifies that the name may be used to refer to normal local printer and punch devices; 
that is, printer and punch devices that are to receive normally routed output. 
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&DMNDSET (Demand 
Setup Option) 



&ESTIME (Default 
Estimated Execution 
Time) 



&ESTLNCT (Default 
Estimated Print Output) 



&ESTPUN (Default 
Estimated Punch Output) 



&DMNDSET=YES/NO 

The &DMNDSET parameter specifies whether inline printer setup will be allowed for 
data sets whose SYSOUT class matches the job message class. 

If the default value is not used, all SYSOUT data sets that are not specified for special 
processing in any other way (for example, HOLD) and whose class matches the job's 
message class, are printed on one printer with appropriate setup messages to the operator 
as the data sets are printed. 

If &DMNDSET=NO is specified or if the SYSOUT class does not match the message class, 
separate class work queues are created for each unique setup required. Thus, data sets can 
be printed simultaneously on all printers available. 

Default: NO 

&ESTIME=nnnn 

The &ESTIME parameter specifies, in minutes, the default estimated execution time for a 
job. This value is used if you do not specify a value for estimated execution time in the 
accounting field of the JOB card or on a /*JOBP ARM control card. 

Lower Limit: 1 

Upper Limit: 1440 (24 hours) 

Default: 2 

&ESTLNCT=nnnn 

The &ESTLNCT parameter specifies, in thousands of lines, the default estimated print 
line count for a job. This value is used if you do not specify a value for the estimated 
print line count in the accounting field of the JOB card or on a /*JOBPARM control 
card. 

Lower Limit: 

Upper Limit: 9999 

Default: 2 

&ESTPUN=nnnnnnn 

The &ESTPUN parameter specifies, in number of cards, the default estimated punched 
card output for a job. This value is used if you do not specify a value for the estimated 
card count in the accounting field of the JOB card or on a /*JOBPARM control card. 

Lower Limit: 

Upper Limit: 9999999 

Default: 100 
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Innnn (Logical Initiator) Innnn CLASS^j . . . c n 

DRAIN/STARI 

NAME=cc 



The Innnn parameter specifies the characteristics of one logical initiator. Initiators are 
numbered consecutively (11-11332) for the number of initiators specified by the 
&MAXPART parameter. Initiator characteristics are specified by the following 
subparameters. 

CLASS=Ci . . . c n 

specifies the job classes (in order of their priority) from which this initiator will schedule 
jobs. You can specify any number of job classes (A-Z,0-9) up to 36. Those in excess of 
the number specified by the &MAXCLAS parameter are ignored. 

Default: If not specified, JES2 assigns job classes in the following manner: 
For Logical Initiator Default Classes Are 

11 A 

12 BA 

13 CBA 



126 ZYX . . . CBA 

127 OZYX . . . CBA 

128 10ZYX . . . CBA 



136 987 .. . CBA 

137 987 .. . CBA 



199 987 .. . CBA 

Note: When &MAXCLAS specifies a number less than 36, JES2 determines the default 
fob classes as shown above, but recognizes only the number of them allowed by the 
&MAXCLAS value. For instance, when 18 is assigned default classes HGFEDCBA, but 
&MAXCLASS=5, JES2 recognizes only the first five (HGFED) job classes as default 
classes for 18. 

DRAIN/ START 

DRAIN specifies that this initiator will be started by operator command. 

Default: START specifies that this initiator is to be started automatically when JES2 
starts processing. 

NAME=cc 

specifies a unique name that the operator can use to refer to this initiator, cc may be 1 or 
2 characters (A-Z,0-9). 

Default: nnnn of the Innnn specification. (Beyond 199, you must specify a name.) 
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INTRDR (Internal INTRDR AUTH=n 

Readers) CLASS=c 



HOLD/ NOHOLD 

PRIOINC=nn 

PRIOLIM=nn 

The INTRDR parameter specifies the characteristics of all JES2 internal readers defined 
by the &NUMINRS parameter. An internal reader is a special SYSOUT data set that 
other programs can use to submit jobs, control statements, and commands to JES2. 
External readers (for example, RDR) and time-sharing users use the internal readers to 
submit jobs from direct access devices or tapes. Internal readers are treated like physical 
input devices. Internal reader characteristics are specified by the following subparameters. 

AUTH=n 

specifies the command authority number for internal readers. This number authorizes 
certain JES2 commands to be submitted through an internal reader, n is a number from 
0-7 defining the kind of commands that can be entered: 

7 — display only 

6 — system authority 

5 — device authority 

4 — system and device authority 

3 — job authority 

2 — system and job authority 

1 — device and job authority 

— system, device, and job authority 

This command authority can be changed at any time by the operator. 

Note: The numbers defining these command authorities are intentionally opposite to the 
numbers of the command authorities defined for the $T operator command. 

Default: 

CLASS=c 

specifies the default job class to be assigned to all jobs submitted through an internal 
reader that do not specify a job class in the CLASS operand of their JOB statements, c 
can be any character A-Z,0-9. 

Default: A 

HOLD/ NOHOLD 

HOLD specifies that all jobs submitted through an internal reader are to be held after JCL 
conversion until they are released for execution by the operator. 

Because all internal readers are treated as a single facility, if one internal reader is held, all 
internal readers are held. This can be particularly troublesome if TSO users are submitting 
jobs and the central operator has held the internal readers. This can be overcome by 
several operating techniques: 

• All jobs submitted through an internal reader can be assigned a class and that class can 
be held by means of a JES2 parameter library entry or the $HQn operator command. 

• Jobs submitted through the internal reader can use the TYPRUN=HOLD parameter on 
the JOB card. 

• Jobs submitted through an internal reader can be individually held with the $HJ 
operator command. 
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Default: NOHOLD, which specifies that jobs submitted through an internal reader are to 
be queued as usual. 

PRIOINC=nn 

specifies a number (0-15) to be added to the selection priorities of all jobs submitted 
through internal readers. If the total of this number and a job's priority exceeds the value 
specified by PRIOLIM, JES2 assumes the priority specified by PRIOLIM. 

Default: 

PRIOLIM=nn 

specifies the maximum priority level (0-15) that can be assigned to jobs submitted 
through an internal reader. If a job's priority (with or without the increment specified by 
PRIOINC) exceeds this level, it will be reduced to this level. 

Default: 15 



&JCOPYLM (Maximum 
Job Output Copies) 



&LINECT (Lines Per 
Page Limit) 



&JCOPYLM=nnn 

The &JCOPYLM parameter specifies the maximum number of job output copies that can 
be requested in the accounting field of the JOB card or on a /*JOBPARM control card. If 
the number of copies requested is greater than the value of &JCOPYLM, the request is 
reduced to the value of &JCOPYLM. No error message is produced. 

The setting of this parameter does not affect requests for multiple copies of data sets 
through a /*OUTPUT control card. 

Lower Limit: 1 

Upper Limit: 255 

Default: 3 

&LINECT=nnn 

The &LINECT parameter specifies the maximum number of lines to be printed per page 
of a job's printed output. This value is used if you do not specify a value for line count in 
the accounting field of the JOB card or on a /*JOBPARM control card. 

&LINECT=0 causes automatic page overflow (normally standard in JES2) to be 
suppressed unless overridden by the JOB card accounting parameter or a /*JOBPARM 
control card specification. 

If a print data set is generated without any ejects (that is, no skips to any channel in the 
carriage tape), and if is specified in this parameter, the JOB card accounting field, or a 
/*JOBPARM control card, the data set is treated as one page when forward-spaced, 
backspaced, interrupted, or warm started while printing. 

Lower Limit: 

Upper Limit: 255 

Default: 61 
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Note: When using standard forms (14 7/8 X 11), a 3800 printer will not print more than 
60 lines per page at 6 lines per inch or 80 lines per page at 8 lines per inch. 



LINEnnn (RJE Lines) LINEnnn CODEB /CODEA 

FDUPLEX/ HDUPLEX 

HISPEED/ LOWSPEED 

IFACEB/ IFACEA 

NOADISC/ ADISCON 

PASSWORD=cccccccc 

TRANSP/ NOTRANSP 

UNIT=cau/SNA 

USASCH/ EBCDIC 



The LINEnnn parameter specifies the characteristics of one teleprocessing line or logical 
line (for SNA RJE terminals) to be used during remote job entry. This parameter should 
be specified for each teleprocessing line. Lines are numbered consecutively 
(LINE1-LINE255) for the number of lines specified by the &NUMLNES parameter, 
line characteristics are specified by the following subparameters. 

Note: // UNIT=SNA is specified, all other LINEnnn subparameters, except PASSWORD, 
are ignored. 

CODEB/ CODEA 

CODEB specifies code B for this line. Code B refers to the second code in a BSC adapter 
that has the Dual Code feature. If the Dual Code feature is not present, CODEB should 
not be specified. 

Default: CODE A which specifies code A for this line; Code A refers to the first code in a 
BSC adapter that has the Dual Code feature. 

FDUPLEX/ HDUPLEX 

FDUPLEX specifies that this is a duplex line. 

Default: HDUPLEX, which specifies that this is a half-duplex line. 

HISPEED/ LOWSPEED 

HISPEED specifies that this is a high-speed (greater than 9600 bits per second) line. 

Default: LOWSPEED, which specifies that this is a low-speed line. 

IFACEB/ IFACEA 

IFACEB specifies interface B for this line. Interface B refers to the second interface in a 
BSC adapter that has the Dual Communications Interface feature. If the adapter fortius 
line does not have the Dual Communications Interface feature, IFACEB should not be 
specified. 

Default: IF ACE A, which specifies interface A for this line; Interface A refers to the first 
interface in a BSC Adapter that has the Dual Communications Interface feature. 

NOADISC/ ADISCON 

NOADISC specifies that this line is not to be automatically disconnected from a terminal 
when the local modem disconnects. 

Default: ADISCON, which specifies that this line is automatically disconnected when the 
local modem disconnects. 
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PASSWORD=cccccccc 

specifies a security password (1-8 alphanumeric characters) to prevent unauthorized 
terminals from using this line. (This password may be used in the connection request 
from remote terminals.) 

Default: No password. 

TRANSP/ NOTRANSP 

TRANSP specifies that the Text Transparency feature of the BSC Adapter is present on 
this line. 

Default: NOTRANSP, which specifies that the Text Transparency feature of the BSC 
Adapter is not present on this line. 

UNIT=cau/SNA 

specifies the unit address of this teleprocessing line (cau), or defines this teleprocessing 
line as a logical line (SNA). 

Default: If not specified, JES2 assigns the first available BSC line address. 

Notes: 

1. The same unit address may be specified for more than one line to allow use of 
different interfaces or codes available in a single BSC Adapter. JES2 will allow only 
one of these lines to be started by the operator at any one time. 

2. If UNIT=SNA is specified, all other LINEnnn subparameters, except PASSWORD, 
are ignored. 

USASCII/ EBCDIC 

USASCH specifies that the BSC Adapter is configured for ASCII line-control characters. 
When USASCII is specified, this line must be used with a 2770, 2780, or 3780 ASCII 
terminal. 

Default: EBCDIC, which speciifes that the BSC Adapter is configured for EBCDIC 
line-control characters. 



LOGON1 (Identification LOGON 1 APPLID=cccccccc 
of JES2 to VTAM) PASSWORD=cccccccc 



The LOGON 1 parameter identifies JES2 as an application program to VTAM. Both of the 
subparameters for this parameter are optional. 

APPLID=cccccccc 

specifies the name, one to eight characters, that the installation has assigned to JES2. This 
name must match the name defined to VTAM (see OS/VS2 MVS System Programming 
Library: VTAM for more information about VTAM definition). 

Default: JES2 

PASSWORD=cccccccc 

specifies the password, one to eight alphanumeric characters, presented to VTAM. 
(Passwords with fewer than eight characters are padded with blanks.) This password must 
have been associated with the above APPLID at VTAM system definition. 

Default: No password is used. 
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&MAXCLAS (Maximum 
Job Classes) 



&MAXDORM (Maximum 
Dormancy) 



&MAXJOBS (Maximum 
Jobs in Job Queue) 



&MAXPART (Maximum 
Logical Initiators) 



&MAXCLAS=nn 

The &MAXCLAS parameter specifies the maximum number of job classes that may be 
specified through the JES2 operator command $TInn. Because there are 36 unique job 
classes, the maximum value that can be specified is 36. 

Lower Limit: 1 

Upper Limit: 36 

Default: 8 

&MAXDORM=nnnn 

The &MAXDORM parameter specifies, in hundredths of a second, the maximum time a 
member of a multi-access spool configuration may refrain from attempting to gain 
control of the shared queues. 

When processors are active in JES2, this parameter has little meaning because, of 
necessity, control of the shared queues is frequently requested. However, when JES2 is 
idle, this parameter ensures that JES2 periodically looks at the shared queues for work 
for which it is eligible and which another member of the configuration may have placed 
there. 

Note: // the value specified for &MAXDORM is too small, excessive system time could 
be expended in unnecessary attempts to reacquire the queue. However, if the value 
specified is too large, the start of certain functions and the responses to certain display 
commands may be delayed. 

Lower Limit: 100 

Upper Limit: 6000 

Default: 500 (5 seconds) 

&MAXJOBS=nnnn 

The &MAXJOBS parameter specifies the maximum number of jobs that can be in the 
JES2 job queue at any given time. 

Lower Limit: 10 

Upper Limit: 8000 

Default: 100 

&MAXPART=nnnn 

The &MAXPART parameter specifies the number of JES2 logical (batch) iniators to be 
defined. If this number is greater than 99, the user must provide a unique ID for each 
initiator after the first 99 by means of the Innnn parameter. 

Lower Limit: 1 
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&MINDORM (Minimum 
Dormancy) 



&MINHOLD (Minimum 
Queue Control Interval) 



&MINJOES (Free JOE 
Count) 



Upper Limit: 1332 

Default: 3 

Note: // the IPL parameter MAXUSER is specified as less than 1335, the upper limit of 
&MAXPART, 1332, is reduced automatically to 3 less than the value of MAXUSER. For 
information about MAXUSER, refer to 0S/VS2 System Programming Library: Initializa- 
tion and Tuning Guide under the IEASYSxxx PARMLIB member description. 

&MINDORM=nnnn 

The &MINDORM parameter specifies, in hundredths of a second, the minimum time a 
member of a multi-access spool configuration must wait after releasing control of the 
shared queues before again attempting to gain control of them. 

This parameter is used to prevent one member of a multi-access spool configuration from 
monopolizing control of the shared queues. 

Lower Limit: 

Upper Limit: 3000 

Default: 100 (1 second) 

&MINHOLD=nnnnnnnn 

The &MINHOLD parameter specifies, in hundredths of a second, the minimum length of 
time a member of a multi-access spool configuration must maintain control of the shared 
queues after gaining control of them. 

This parameter is provided to minimize the thrashing that could occur with the shared 
queues in a purely contention environment (one in which all members of the 
configuration specify &MINHOLD=0). 

Note: Setting this parameter to a high value will tend to immobilize other members of 
the configuration. 

Lower Limit: 

Upper Limit: 99999999 

Default: 100(1 second) 

&MINJOES=nnnn 

The &MINJOES parameter specifies the minimum number of free job output elements 
(JOES). When the free count drops below this value, no new work is added to the 
in-storage queues until the termination of a print or punch activity raises the free count. 

If the free job output element count is allowed to go to by means of operator use of the 
$1 command in a congested system, output devices may become interlocked waiting for 
resources. 
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&MLBFSIZ (MULTI- 
LEAVING Buffer Size) 



&MSGID (Message ID 
Option) 



Note: JES2 reduces the value specified for &MINJOES, if necessary, so that the value is 
at least 2 less than the value specified for the &NUMJOES parameter. 

Lower Limit: 2 

Upper Limit: 4998 

Default: &NUMJOES/5 

&MLBFSIZ=nnnn 

The &MLBFSIZ parameter specifies the size, in bytes, of each JES2 MULTI-LEAVING 
buffer. The specification for this parameter must be a positive even integer. 

Satisfactory support of one device of each type (reader, printer, punch, console) on 8K 
terminal CPUs is based on the assumption that &MLBFSIZ is 400 or less. If the 
supported terminals include any 8K CPUs, it is recommended that &MLBFSIZ not be 
increased above 400, even if support of a nonprogrammable terminal requires increasing 
the value specified in the &TPBFSIZ parameter to 516. 

Note: &MLBFSIZ must be a multiple of 2. If not, it is automatically rounded up. If the 
value specified is greater than that specified for &TPBFSIZ, &TPBFSIZ is rounded up. 

Lower Limit: 128 

Upper Limit: 3976 (dependent upon JES2 macro expansions) 

Default: 400 

&MSGID=YES/NO 

The &MSGID parameter specifies whether or not the eight-character message identifier 
(HASPnnnJf)) should be appended to the beginning of each JES2 operator message. 

Note: // the default value is not used, the operator messages produced by JES2 will vary 
from their documentation in OS/VS Message Library: VS2 System Messages. 

Default: YES 



&NIPFCB (Forms Control &NIPFCB=cccc 
Buffer Image for 
Nonimpact (3800) 
Printers) 



The &NIPFCB parameter specifies the name of both the forms control buffer image that 
JES2 initially loads into every 3800 printer and the installation's default FCB for data 
sets that do not explicitly request an FCB. &NIPFCB is a one- to four-character name 
that is valid in SYS1.IMAGELIB. The FCB identifier can be modified for an individual 
printer by means of the PRINTERnn parameter or the set ($T) operator command. 

Default: If this parameter is not coded or if it is coded as &NIPFCB=, (that is, cccc is 
one or more blanks), the 3800 printer constructs an FCB based on the forms size. 
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&NIPUCS (Character 
Arrangement Table for 
Nonimpact (3800) Printers) 



&NOPRCCW (Printer 
Channel Program Limit) 



&NOPUCCW (Punch 
Channel Program Limit) 



&NIPUCS=cccc 

The &NIPUCS parameter specifies the name of both the character arrangement table that 
JES2 initially loads into every 3800 printer and the installation's default character 
arrangement table that is loaded into the printer for data sets that do not specify a 
character arrangement table. &NIPUCS is a one- to four-character name that is valid in 
SYS1.IMAGELIB. The character arrangement table can be changed for an individual 
printer by means of the PRINTERnn parameter or the set ($T) operator command. 

Default: GF10 

&NOPRCCW=nnn 

The &NOPRCCW parameter specifies the maximum number of channel command words 
to be used per channel program area for local impact printers. The recommended value 
for this parameter can be determined by the following formula: 

&NOPRCCW=&BUFSIZE * average print line length 

The average length of the print line should be estimated with an allowance for truncation 
of trailing blanks by JES2. 

Note: This value is ignored for 3800 printers. JES2 was a CCW area that has a fixed size 
for 3800 printers. 

Lower Limit: 1 

Upper Limit: 255 

Default: &BUFSIZE -f 80 

&NOPUCCW=nnn 

The &NOPUCCW parameter specifies the maximum number of channel command words 
to be used per channel program area for local punches. The recommended value for this 
parameter can be determined by the following formula: 

&NOPUCCW = &BUFSIZE -r average card length 

The average card length should be estimated with an allowance for truncation of trailing 
blanks by JES2. 

Note: If a 3525 is interpreting (FUNC=I on the DD card), the &NOPUCCW must be at 
least 2. 

Lower Limit: 1 

Upper Limit: 255 

Default: &BUFSIZE-f 80 



&NUMACE (Automatic 
Command Limit) 



<SNUMACE=nnnn 

The &NUMACE parameter specifies the number of automatic commands that can be 
concurrently active in JES2. The value should be large enough to permit operators to 
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leave a JES2 dynamic display in each "out of line" area of all graphic display consoles as 
well as one on each printer console controlled by MVS. 

For additional information, see the description of the $TA command in Operator's 
Library: OS/VS2JES2 Commands. 

Lower Limit: 2 

Upper Limit: 9999 

Default: 20 



&NUMBUF (JES2 I/O &NUMBUF=nnnn 

Buffer Count) 



The &NUMBUF parameter specifies the number of I/O buffers to be included in the 
JES2 load module. The value specified should reflect the total number of buffers required 
for proper operation of JES2. 

Because all JES2 buffers are maintained in a dynamic pool until required by an active 
function, the appropriate number of buffers should be based on the predicted 
simultaneity of the various functions required at the installation. The following list 
indicates the number of buffers required for each logical function. (A defined function 
that is inactive requires no buffers.) 

6 for normal system processing 

5 for each local reader 

4 for each internal reader 

4 for each remote reader 

1 for each remote punch (2 if &RPUBOPT=YES) 

1 for each local punch (2 if &PUNBOPT=YES) 

1 for each remote printer (2 if &RPUBOPT= YES) 

2 for each local printer with DSPLSNGL specified (1 if &PRTBOPT=NO) 

2 X &TCELSIZ for each local printer with DSPLTCEL specified (&TCELSIZ if 
&PRTBOPT=NO) 

Lower Limit: 15 

Upper Limit: 2000 

Default: 20 + 4 X &NUMRDRS + (&NUMPRTS -n 1 )Xn 2 +n 1 Xn 2 X &TCELSIZ + 
&NUMPUNS X n 3 + &NUMLNES X (3 + n 4 + n 5 ) 

where: 

nj = number of local printers with DSPLTCEL specified 
n 2 = 2 if &PRTBOPT=YES 

lif&PRTBOPT=NO 
n 3 = 2 if &PUNBOPT=YES 

lif&PUNBOPT=NO 
n 4 =2if&RPRBOPT=YES 

lif&RPRBOPT=NO 
n 5 = 2 if &RPUBOPT=YES 

lif&RPUBOPT=NO 
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&NUMCLAS (Printer/ 
Punch SYSOUT Class 
Limit) 



&NUMCMBS (Number of 
JES2 Console Message 
Buffers) 



&NUMDA (JES2 Spool 
Volume Limit) 



&NUMCLAS=nn 

The &NUMCLAS parameter specifies the maximum number of classes for which a printer 
or a punch may be simultaneously started. 

Lower Limit: 1 

Upper Limit: 36 

Default: 8 

&NUMCMBS=nnn 

The &NUMCMBS parameter specifies the number of console message buffers to be 
provided for JES2. The number of buffers specified should be sufficient to accommodate 
all outstanding operator requests and still allow message processing to continue. 

Message buffers are allocated from the Common Storage Area so you should be careful in 
determining this number. When RJE is used, more message buffers are usually needed. 
This is especially true with console support for MULTI-LEAVING terminals. Also, 
specifying too few message buffers can cause serious system degradation. 

During periods of high console activity, when no message buffers are available, certain 
noncritical JES2 messages are discarded to avoid delaying the associated process. These 
noncritical messages include certain RJE-oriented messages, excession messages (for 
execution time, lines, cards), and certain I/O error messages on JES2-controlled devices. 

For a MULTI-LEAVING terminal console, if more messages are queued than the number 
of buffers specified in this parameter, the excess messages are spooled and later printed. 
Normal message processing resumes after the terminal accepts those messages that were 
queued prior to reaching the &NUMCMBS limit. 

Lower Limit: 3 

Upper Limit: 999 

Default: 15 

&NUMDA=nn 

The &NUMDA parameter specifies the maximum number of direct-access volumes that 
can be mounted concurrently as spool volumes. All direct-access devices supported in 
OS/VS2 are eligible for use as spooling devices. Specifying a large number for &NUMDA 
may require increasing the value of &BUFSIZE. 

Refer to the information on the &NUMTGV parameter for related information. 

Lower Limit: 1 

Upper Limit: 36 

Default: 2 
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&NUMINRS (Number of &NUMINRS=nnn 
Internal Readers) 

The &NUMINRS parameter specifies the number of internal readers to be part of JES2. 

Lower Limit: 

Upper Limit: 255 

Default: 2 



&NUMJOES (Number of 
Job Output Elements) 



&NUMJOES=nnnn 

The &NUMJOES parameter specifies the number of job ouptut elements to be generated. 
Although a value as small as 10 will be accepted, performance is degraded if a value 
smaller than the default is specified. 

One job output element is required for: 

• Each unique SYSOUT class that appears in a job that is queued for output 

• Each active printer or punch 

• Each interrupted or restarted job that is not currently active on a printer or punch 

• Each unique combination of Forms ID, UCS ID, and FCB ID for all jobs currently 
queued for output 

• Each job that was interrupted by a system failure while being printed or punched and 
has not yet been restarted on an output device. 

Specifying too small a value results in jobs waiting for in-storage queuing in order to 
complete active print or punch work. 

Lower Limit: 10 

Upper Limit: 5000 

Default: 10 times the total number of local and remote printers and card punches. 



&NUMLNES (Number of &NUMLNES=nnn 
Teleprocessing Lines) 



The &NUMLNES parameter specifies the largest teleprocessing line identification 
number; thus, the number of line definitions to be used by JES2. This value includes the 
number of lines defined as logical lines for SNA RJE terminals. 

Lower Limit: 

Upper Limit: 255 

Default: 



&NUMPRTS (Local 
Printers Used by JES2) 



&NUMPRTS=nn 

The &NUMPRTS parameter specifies the maximum number of local printers JES2 can 
use to print job output. 
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If more printers are specified during system generation than are specified in this 
parameter, a message is written to the operator. JES2 initialization continues normally, 
but only the printers specified or those with the lowest unit addresses are used. 

Lower Limit: 



&NUMPUNS (Local 
Punches Used by JES2) 



Upper Limit: 99 
Default: 2 

&NUMPUNS=nn 



The &NUMPUNS parameter specifies the maximum number of local punches JES2 can 
use to punch job output. JES2 supports 2520, 2540, and 3525 card punches. 

If more punches are specified during system generation than are specified in this 
parameter, a message is written to the operator. JES2 initialization continues normally, 
but only the punches specified or those with the lowest unit addresses are used. 

Lower Limit: 

Upper Limit: 99 

Default: 1 

&NUMRDRS (Local Card &NUMRDRS=nn 

Readers Used by JES2) 

The &NUMRDRS parameter specifies the maximum number of local card readers JES2 
can use to read jobs. JES2 supports 2501, 2540, and 3505 card readers. 

If more card readers are specified during system generation than are specified in this 
parameter, a message is written to the operator. JES2 initialization continues normally, 
but only the card readers specified or those with the lowest unit addresses are used. 

Lower Limit: 

Upper Limit: 99 

Default: 1 



&NUMRJE (Number of 
Remote Terminal 
Definitions) 



&NUMRJE=nnn 

The &NUMRJE parameter specifies the number of remote terminal definitions to be used 
by JES2. 

Lower Limit: 

Upper Limit: 255 

Default: The value specified for the &NUMLNES parameter. 
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&NUMSMFB (JES2 SMF 
Buffer Count) 



&NUMTGV (Number of 
Track Groups per Volume) 



&NUMTPBF (Number of 
JES2 Teleprocessing 
Buffers) 



&NUMSMFB=nnn 

The &NUMSMFB parameter specifies the number of system management facility (SMF) 
buffers to be generated by JES2. 

If the value specified is less than 2, JES2 neither produces SMF records nor takes the 
SMF exit, IEFUJP. 

Lower Limit: 

Upper Limit: 255 

Default: 5 

&NUMTGV=nnnnn 

The &NUMTGV parameter specifies the number of units (track groups) into which each 
spool volume is divided for JES2 allocation purposes. The specification must be an 
integer no greater than the number of tracks on the spool device with the fewest tracks. 

You should decide upon the number of tracks required in a track group and then divide 
by that number the total number of tracks (except alternate tracks) on a typical spool 
device at your installation. For example, to obtain a track group size of 10 tracks on a 
2314, you would specify a value of 400 in this parameter. If, at some time, your 
installation uses a 3330 as a spool device, the track group size for the 3330 would 
automatically become 19 tracks. 

For each spool volume found during initialization, JES2 calculates the number of tracks 
per group by dividing the total number of tracks on the volume by the value specified in 
this parameter. It then marks as unavailable for JES2 spooling all track groups that lie 
partially or wholly outside the first extent of data set SYS1.HASPACE on that volume. 

Specifying a large value in this parameter may require specifying a large value in the 
&BUFSIZE parameter. 

Lower Limit: 100 

Upper Limit: 29120 

Default: 400 

Note: The upper limit is dependent upon the current JES2 control block definitions. 

&NUMTPBF=nnnn 

The &NUMTPBF parameter specifies the number of teleprocessing buffers to be 
generated for RJE by JES2. This value includes the buffers required for remote terminals 
supported as logical units. 

Each signed-on JES2 MULTI-LEAVING terminal requires at least two JES2 teleprocess- 
ing buffers. The minimum requirement for SNA is three buffers plus two buffers for 
every SNA RJE terminal. All other signed-on terminals require at least one buffer each. 
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If a MULTI-LEAVING terminal has more than one output function running concurrent- 
ly, additional buffers can be used to increase performance. It is recommended that this 
value be made liberally large (for example, 5*&NUMLNES) in systems that support 
MULTI-LEAVING terminals. For additional information, refer to the &TPBFSIZ and 
&MLBFSIZ parameters. 

Lower Limit: 

Upper Limit: 2000 

Default: The value specified for the &NUMLNES parameter. 



&OUTPOPT (Option for 
Exceeding Estimated Job 
Output) 



&OUTPOPT=0/l/2 

The &OUTPOPT parameter specifies the action to be taken when a job exceeds its 
estimated print lines or punched cards of output. Regardless of the specification for this 
parameter, exceeding estimated output causes messages to be written to the operator. 
(Refer to the &OUTXS parameter for additional information.) 



allows the job to continue execution. 

1 

causes the job to be canceled without a dump. 



causes the job to be canceled with a dump. If 2 is specified, you should use SYSUDUMP 
or SYSABEND DD cards if a storage dump is desired when estimated output is exceeded. 

Note: If 1 or 2 is specified, the job will not be canceled if the job step task is normally or 
abnormally terminating at the time the estimated output is exceeded. 

Default: 



&OUTXS (Message Interval 
for Exceeding Estimated 
Output) 



&OUTXS=nnnnnnn 

The &OUTXS parameter specifies the interval, in print lines or punched cards, at which 
messages wil be written to inform the operator that a job's print line count or punch card 
count has been exceeded. 



The first message for exceeding estimated print line or punched card output is written to 
the operator when the job's estimated print line or punched card count, respectively, has 
been exceeded. 

Lower Limit: 500 

Upper Limit: 9999999 

Default: 2000 



&PRIDCT (Local Printer 
Separator Page Line 
Count) 



&PRIDCT=nnn 

The &PRIDCT parameter specifies the number of print lines to appear on each JES2 job 
separator page for local printers. If the specification is 0, no separator pages are produced. 
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&PRIHIGH (Selection of 
Upper Priority Limit) 



&PRILOW (Selection of 
Lower Priority Limit) 



If the specification is 30 or greater, the first 29 lines are used to produce a block-lettered 
is 30 or greater, the first 29 lines are used to produce a block-lettered job name, job 
number, and SYSOUT class. 

The equivalent parameter for remote terminal printers is &TPIDCT. 

Note: A 3800 printer will not print more than 60 lines per page at 6 lines per inch or 80 
lines per page at 8 lines per inch. 

Lower Limit: 

Upper Limit: 255 

Default: 61 

&PRIHIGH=nn 

The &PRIHIGH parameter specifies the upper priority limit to be associated with the 
JES2 priority aging feature. A job will not be priority-aged if its priority is (or becomes) 
greater than or equal to the value specified in this parameter. 

Lower Limit: 

Upper Limit: 15 

Default: 10 

&PRILOW=nn 

The &PRILOW parameter specifies the lower priority limit to be associated with the 
JES2 priority aging feature. A job will not be priority-aged unless its priority is initially 
equal to or greater than this value. (Refer to the &PRIRATE and &PRIHIGH parameters 
for additional information.) 

Lower Limit: 

Upper Limit: 15 

Default: 5 



PRINTERnn (Local 
Printer) 



PRINTERnn 



BURST/ NOBURST 

CLASS^! ...c n 

DRAIN/ START 

DSPLTCEL/ DSPLSNGL 

FCB=cccc 

FORMS=cccc 

MARK/ NOMARK 

NQSEP/SEP 

OPERATOR/ AUTO 

PAUSE/ NOPAUSE 

ROUTECDE=nnn 

UCS=cccc 

UNIT=cau 
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The PRINTERnn parameter specifies the characteristics of one local printer. Printers are 
numbered consecutively (PRINTER1-PRINTER99) for the number of printers specified 
by the &NUMPRTS parameter. Printer characteristics are defined by the following 
subparameters. 

BURST/ NOBURST 

BURST specifies that the printed output from a 3800 printer is to be burst into separate 
sheets. 

Default: NOBURST, which specifies that the printed output from a 3800 printer is to be 
in continuous, fanfold mode. 

CLASS=Cx . . . c n 

specifies the output classes, in priority sequence, to be processed initially by this printer. 
You can specify any number of classes (A-Z,0-9) up to the number of classes specified by 
the &NUMCLAS parameter. 

Default: AJ 

DRAIN/ START 

DRAIN specifies that this printer is to be started by operator command. 

Default: START, which specifies that this printer (if it is ready) is to be automatically 
started when JES2 starts processing. 

DSPLTCEL /DSPLSNGL 

DSPLTCEL specifies that an entire track cell is to be despooled in one operation for data 
sets that belong to a SYSOUT class that has the track-cell characteristic (see the 
description of $$x). The number of records in the track cell is governed by the 
&TCELSIZ parameter. 

Note: Specifying DSPLTCEL and double buffering (&PRTBOPT=YES) indicates double 
track-cell buffering. 

Default: DSPLSNGL, which specifies that spool records are to be despooled one record 
per despooling operation. 

FCB=cccc 

specifies for impact printers the forms control buffer image or the carriage control tape 
that is to be initially mounted on this printer. For the 3800, a nonimpact printer, cccc 
specifies the name of both the FCB image that JES2 initially loads into the printer and 
the installation's default FCB image for data sets not specifying an FCB. 

For all printers, cccc is the forms control buffer (FCB) identifier (1 to 4 alphanumeric 
characters) that resides in SYS1.IMAGELIB. (Refer to OS/VS2 System Programming 
Library: Data Management for information on how to add impact printer FCBs to 
SYS1.IMAGELIB. For information about the 3800, refer to IBM 3800 Printing 
Subsystem Programmer's Guide.) 

Default: For impact printers, the identifier specified by the &PRTFCB parameter; for 
the 3800, the identifier specified by the &NIPFCB parameter. 

FORMS=cccc 

specifies the forms identifier (1 to 4 alphanumeric characters) of the forms that are to be 
loaded initially in this printer. 
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Default: The forms identifier specified by the &STDFORM parameter. 

MARK/ NOMARK 

MARK specifies for a 3800 printer that there is marking on the edge of the separator 
page. 

Default: NOMARK, which specifies for a 3800 printer that there is no marking on the 
edge of the separator page. 

NOSEP/SEP 

NOSEP specifies that separator pages are not to be initially provided between data set 
groups. (Separator pages can be specified later by the $T operator command.) 

Default: SEP, which specifies that separator pages are to be initially provided between 
data set groups. 

Note: // a zero number of print lines was specified for the &PRIDCT parameter, 
separator pages will not be produced even if SEP is specified. 

OPERATOR/ AUTO 

OPERATOR specifies that this printer is to operate initially in operator-controlled 
(forms) mode. 

Default: AUTO, which specifies that this printer is to operate initially in automatic 
(demand) forms mode. 

PAUSE/ NOPAUSE 

PAUSE specifies that this printer is to pause between data set groups. 

Default: NOPAUSE, which specifies that this printer is not to pause between data set 
groups. 

ROUTECDE=nnn 

specifies the internal route code to be assigned to this printer. A route code indicates that 
this printer is to be eligible for special print routing, nnn may be or any value between 1 
and 255. 

Note: Route codes for local devices should be used cautiously. Once a printer has been 
assigned a route code, it will only be considered as an available output device for a job 
that requests printed output via the ROUTE control statement, the DEST keyword on 
the OUTPUT control statement, or by operator command. 

Default: 0, which indicates no special routing. 

UCS=cccc 

specifies for impact printers the print train (or print chain) that is mounted on this 
printer, cccc is the identifier (1 to 4 characters) of a universal character set (UCS) image 
that resides in SYS1.IMAGELIB. (Refer to OS/VS2 System Programming Library: Data 
Management for information on how to add a UCS image to SYS1.IMAGELIB.) 

For 3800 printers, cccc specifies both the character arrangement table that'JES2 initiallly 
loads into the printer and the installation's defauit character arrangement table for data 
sets not specifying any character arrangement table. (Refer to IBM 3800 Printing 
Subsystem Programmer's Guide for information about the IBM-supplied character 
arrangement tables and the addition of other character arrangement tables to 
SYS1.IMAGELIB.) 
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If you specify an invalid identifier, JES2 bypasses this loading procedure and issues a 
setup message so the operator can specify a valid image. 

Note: This subparameter is only valid for a 3211, a 1403 printer that has the UCS 
feature, or a 3800 printer. If you specify UCS=0 (or if a zero value was specified for the 
&PRTUCS parameter), JES2 will not load the UCS buffer. 

Default: For impact printers, the identifier specified by the &PRTUCS parameter; for 
the 3800 printer, the identifier specified by the &NIPUCS parameter. 

UNIT=cau 

specifies the unit address of this printer. 

Default: If not specified, JES2 assigns the first available printer address'that is not 
already assigned. 

&PRIOOPT (JES2 &PRIOOPT=YES/NO 

/♦PRIORITY Control 

Statement Support Option) The &PRIOOPT parameter specifies whether the JES2 /*PRIORITY control statement is 

to be supported (YES) or ignored (NO). 



&PRIRATE (Priority 
Increment Interval) 



&PRTBOPT (Local 
Printer Double Buffering 
Option) 



Default: YES 

&PRIRATE=nnnn 

The &PRIRATE parameter specifies the number of time periods into which a 24-hour 
day is to be divided for use in incrementing a job's priority by the JES2 priority aging 
feature. For example, if 3 is specified, a job's priority is incremented by 1 for every 8 
hours it remains in the system. However, a job's priority is not incremented unless it is at 
least equal to the value specified in the &PRILOW parameter; nor will a job's priority be 
incremented above the value specified in the &PRIHIGH parameter. If is specified, the 
values specified in the &PRILOW and &PRIHIGH parameters are ignored. 

If a job's priority is specified on a /*PRIORITY control card, the job is priority-aged if its 
priority is eligible. 

Refer to the &RPRT(n), &RPRI(n), &XLIN(n), and &XPRI(n) parameters for additional 
information. 

Lower Limit: 

Upper Limit: 1440 (that is, the job's priority is incremented once every minute) 

Default: 

&PRTBOPT= YES/NO 

The &PRTBOPT parameter specifies whether or not double buffering is to be used for 
local printers. If NO is specified, single buffering is used. 

Default: YES 
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&PRTFCB (Forms Control 
Buffer Image for Impact 
Printers) 



&PRTFCB=cccc 

The &PRTFCB parameter specifies the name of the forms control buffer image or the 
carriage control tape that JES2 initially assumes is mounted on every impact printer. 
&PRTFCB is a one- to four-character name that is valid in SYS1.IMAGELIB. The forms 
control buffer (FCB) identifier can be modified for each printer by means of the 
PRINTERnn parameter or the set ($T) command. 

Default: 6 



&PRTRANS (Print Line 
Translation Option) 



&PRTRANS=YES/NO 

The &PRTRANS parameter specifies whether or not to translate lines of print not 
directed to 3211 printers. If the default value is used, each line to be printed by a local 
1403 or any remote printer is first translated. Translation changes lowercase letters to 
uppercase and characters that are invalid on a PN train to blanks. If any print train is to 
be used on a JES2-controlled local 1403 or on a remote printer that has characters not 
equivalent to those on a PN train, NO must be specified. If all printers are 3211s (not 
1403s or remote printers), this parameter should be specified as NO. 

Note: 3800 printers are handled in the same way as 3211 printers. 

Default: YES 



&PRTUCS (Print 
Chain/Train Image for 
Impact Printers) 



&PRTUCS=cccc 

The &PRTUCS parameter specifies the name of the print chain or print train that JES2 
initially assumes is mounted on every impact printer. &PRTUCS is a one- to 
four-character name that is valid in SYS1.IMAGELIB. The UCS identifier can be 
modified for each printer by means of the PRINTERnn parameter or the set ($T) 
command. 



&PRTYOPT (JOB Card 
PRTY Parameter Support 
Option) 



If is specified, JES2 bypasses the UCS loading procedure until a job that requires a 
specific UCS image is processed. If an invalid specification is encountered, the UCS 
loading procedure is bypassed and a setup message is issued to allow specification of a 
valid image. 

Provisions for supporting other types of print chains are described in OS/VS2 System 
Programming Library: Data Management. 

Default: 

&PRTYOPT= YES/NO 

The &PRTYOPT parameter specifies whether the priority specification (PRTY=) on the 
JOB statement is to be supported (YES) or ignored (NO). 

Default: NO 



&PUNBOPT (Local Punch 
Double Buffering Option) 



&PUNBOPT=YES/NO 

The &PUNBOPT parameter specifies whether or not double buffering is to be used for 
local card punches. If NO is specified, then single buffering is used. 
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Default: NO 

PUNCHnn (Local Card PUNCHnn CLASS^ . . . c n 

Punch) 1 DRAIN/ START 

FORMS=cccc 
NOSEP/SEP 
OPERATOR/ AUTO 
PAUSE/ NOPAUSE 
ROUTECDE=nnn 
UNIT=cau 



The PUNCHnn parameter specifies the characteristics of one local card punch. Punches 
are numbered consecutively (PUNCH 1-PUNCH99) for the number of punches specified 
by the &NUMPUNS parameter. Punch characteristics are specified by the following 
subparameters. 

CLASS=C! . . . c n 

specifies, in priority sequence, the output classes to be processed initially by this card 
punch. You can specify any number of classes (A-Z,0-9) up to the maximum number of 
classes specified by the &NUMCLAS parameter. 

Default: BK 

DRAIN/ START 

DRAIN specifies that this card punch is to be started by operator command. 

Default: START, which specifies that this card punch (if it is ready) is to be 
automatically started when JES2 starts processing. 

FORMS=cccc 

specifies the forms identifier (1 to 4 alphanumeric characters) of the forms that are to be 
loaded initially in this punch. 

Default: The forms identifier specified by the &STDFORM parameter. 

NOSEP/SEP 

NOSEP specifies that separator cards are not to be initially provided between data set 
groups. (Separator cards can be specified later by the $T operator command.) 

Default: SEP, which specifies that separator cards are to be initially provided between 
data set groups. 

OPERATOR/ AUTO 

OPERATOR specifies that this card punch is to. operate initially in operator-controlled 
(forms) mode. 



The dual reader/punch feature is supported by JES2 as shown in the following 
example. Assume that a 3525 with the read feature has a unit address of 013. In the 
JES2 initialization data set, the following two items appear: 

READER2 UNIT=0 13, DRAIN 

PUNCH 1 UNIT=013 

When JES2 is started, the reader will be drained and the punch feature will be 
activated. If the operator later wishes to read data from the 3525, he can drain punch 
1 and start reader 2 with operator commands. 
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Default: AUTO, which specifies that this card punch is operate initially in automatic 
(demand) forms mode. 

PAUSE/ NOPAUSE 

PAUSE specifies that this card punch is to pause between data set groups. 

Default: NOPAUSE, which specifies that this card punch is not to pause between data 
set groups. 

ROUTECDE=nnn 

specifies the internal route code to be assigned to this card punch. A route code indicates 
that this card punch is to be eligible for special punch routing, nnn may be or any value 
between 1 and 255. 

Note: Route codes for local devices should be used cautiously. Once a card punch has 
been assigned a route code, it will only be considered as an available output device for a 
job that requests punched output via the DEST keyword on the OUTPUT control 
statement, the ROUTE control statement, or by operator command. 

Default: 0, which means no route code is to be assigned. 

UNIT=cau 

specifies the unit address of this card punch. 

Default: If not specified, JES2 assigns the first available card punch address that is not 
already assigned. 



&RCOMCHR (Instream &RCOMCHR=c 

Command Identifier) 



The &RCOMCHR parameter specifies the character that will be used to identify all JES2 
operator commands entered from a local or remote card reader. If a JES2 control card is 
read (/* in columns 1 and 2) that contains this character in column 3, JES2 assumes that 
the card is a JES2 command statement and attempts to process the command. 

The specification should be one of the following characters: 



c 


< 


( 


+ 


1 


& 


J 


$ 


* 


) 


J 


"~ ■ 


- 


/ 


% 


— 


> 


? 




# 


@ 



If this parameter is changed to other than its default value, the command control 
statement will vary from the format given in OS/VS2 JCL. 

Note: This character may be the same as that specified for the &B SPACE or 
&CCOMCHR parameters. 

Default: $ 
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&RDROPSL (LOGON 
Conversion Parameter 
Field) 



&RDROPST (Started 
Task Conversion 
Parameter Field) 



&RDROPSL=character string 

The &RDROPSL parameter specifies a 20-character parameter field to be passed to the 
OS/VS2 converter for TSO LOGONs (foreground jobs). For a description of the 
parameter field refer to the &RDROPSU parameter. 

The value of this parameter may be overridden by the &TSU parameter. 

Default: 0001 440000003 0E00000 

&RDROPST=character string 

The &RDROPST parameter specifies a 20-character parameter field to be passed to the 
OS/VS2 converter for console-started tasks. For a description of the parameter field, refer 
to the &RDROPSU parameter. The value of this parameter may be overridden by the 
&STC parameter. 

character string 

specifies a 20-character parameter field. 

Default: 00000 100000000E00000 



&RDROPSU (Batch Job 
Conversion Parameter 
Field) 



&RDROPSU=character string 

The &RDROPSU parameter specifies a 20-character parameter field .to be passed to the 
OS/VS2 converter for batch (background) jobs. 

The form of this specification is: 
bppmmmmsscccrlaaaaef 

where: 



is a numeric character 0, 1, 2, or 3, that indicates whether an account number is required 
and whether a programmer name is required. The following chart shows the meaning of 
each character: 





Accounting 


Programmer 




Information 


Name 


Character 


Required 


Required 





No 


No 


1 


No 


Yes 


2 


Yes 


No 


3 


Yes 


Yes 



Note: This character is always reset to by JES2 for TSO LOGONs and for 
console-started tasks. 



PP 



are currently unused. Code two zeros to maintain positioning within the parameter field. 



mmmmss 

are six numeric characters indicating the default for the maximum time that each job step 
may run. The first four characters indicate minutes, the last two indicate seconds. The 
value specified is subject to the limits described for the TIME parameter in OS/VS2 JCL. 
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ccc 



aaaa 



ef 



three numeric characters indicating the default for the region size (specified as a number 
of 1024-byte blocks) assigned to each job step. This region size is assigned when no region 
size is specified in the JOB and EXEC statements and the job step is to be run with 
ADDRSPC=VIRT. 



is a numeric character 0, 1, 2, or 3, that specifies the disposition of commands read from 
the input stream. The character has the following meanings: 

The OS/VS2 converter passes the command to the command scheduling routine to 
be executed. 

1 The OS/VS2 converter displays the command (by means of a WTO macro 
instruction), and passes it to the command scheduling routine to be executed. 

2 The OS/VS2 converter displays the command (by means of a WTO macro 
instruction), asks the operator whether the command should be executed (by 
means of a WTOR macro instruction), and passes the command to the command 
scheduling routine if the operator replies yes. 

3 The OS/VS2 converter ignores the command and treats it as a no-operation. 



is a numeric character or 1 that specifies the bypass label processing option. The 
character has the following meanings: 

The bypass label processing parameter in the label field of a DD statement is to be 
ignored; the label parameter is processed as no label. 

1 Bypass label processing is not to be ignored; the label parameter is processed as it 
appears. 



are four hexadecimal numbers from 0000 to E000 indicating which operator command 
groups are to be executed. (For a list of the operator command groups, refer to 
Operator's Library: OS/VS2JES2 Commands.) 



tit settings 


\ are as 


follows: 
Bit 




Byte 


Bits 


Settings 


Meaning 






1 

2 
3-7 


1 
1 
1 
00000 


Group 1 commands 
Group 2 commands 
Group 3 commands 
Reserved 


1 


0-7 


00000000 


Reserved 



are two numeric characters that specify a message level value for use when the 
MSGLEVEL parameter is not specified on a JOB statement. If a MSGLEVEL parameter 
is not specified, JCL and allocation/termination messages are recorded in the system 
message data set according to the value specified in this parameter. The characters have 
the following meanings: 

e 

specifies the kinds of JCL listed. The character can be 0, 1, or 2, meaning: 

JOB statement only 



60 



1 Input statement, cataloged procedure statements, and symbolic parameter substitu- 
tion values 

2 Input statements only, including stream procedures 

f 

specifies the kinds of allocation/termination messages listed. The character can be or 1, 
meaning: 

No messages are to be listed, except in the case of an abnormal termination. (In 
that event, all messages are listed.) 

1 All messages are listed. 

The value of this parameter may be overridden by individual job class by the &x 
parameters at JES2 initialization. 

Default: 00000300012820E00001 



READERnn (Local READERnn AUTH=n 

Card Reader) 1 CLASS=c 



DRAIN/ AUTO 

HOLD/ NOHOLD 

MSGCLASS=c 

PRDEST=nnn 

PRIOINC=nn 

PRIOLIM=nn 

PRLCL/ PRRMT 

PUDEST=nnn 

PULCL/ PURMT 

UNIT=cau 

The READERnn parameter specifies the characteristics of one local card reader. Readers 
are numbered consecutively (READER1-READER99) for the number of card readers 
specified by the &NUMRDRS parameter. Reader characteristics are specified by the 
following subparameters. 

AUTH=n 

specifies the command authority number for this card reader. This number authorizes 
certain JES2 commands to be entered at this card reader, n is a number from 0-7 defining 
the kind of commands that can be entered. 

7 — display only 3 — job authority 

6 — system authority 2 — system and job authority 

5 — device authority 1 — device and job authority 

4 — system and device authority — system, device, and job authority 

This command authority can be changed at any time by the operator. 



The dual reader /punch feature is supported by JES2 as shown in the following 
example. Assume that a 3525 with the read feature has a unit address of 013. In the 
JES2 initialization data set, the following two items appear: 

READER2 UNIT=0 13, DRAIN 

PUNCH 1 UNIT=013 

When JES2 is started, the reader will be drained and the punch feature will be 
activated. If the operator later wishes to read data from the 3525, he can drain punch 
1 and start reader 2 with operator commands. 
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Note: The numbers defining these command authorities are intentionally opposite to the 
numbers of the command authorities defined by the $T operator command. 

Default: 

CLASS=c 

specifies the default job class to be assigned to all jobs entered at this card reader that do 
not specify a job class in the CLASS operand of their JOB statements, c can be any class 
(A-Z,0-9). 

Default: A 

DRAIN/ AUTO 

DRAIN specifies that this card reader is to be started by operator command. 

Default: AUTO, which specifies that this card reader (if it is ready) is to be started 
automatically when JES2 starts processing. 

HOLD/ NOHOLD 

HOLD specifies that all jobs entered at this card reader are to be held after JCL 
conversion until they are released for execution by the operator. 

Default: NOHOLD, which specifies that all jobs entered at this card reader are to be 
queued as usual. 

MSGCLASS=c 

specifies the default message class to be assigned to jobs entered at this card reader that 
do not specify a MSGCLASS operand in their JOB statements, c can be any class 
(A-Z,0-9). 

Default: A 

PRDEST=nnn 

specifies the default printer destination for the print output from all jobs that are entered 
at this card reader that do not have a ROUTE statement or DEST parameter, nnn can be 
or it can be a route code (1-255) of a local printer as specified by the PRINTERnn 
parameter or of a remote printer as specified by the RMTnnn parameter. If the route 
code is of a local printer, the PRLCL option must be specified. 

Default: 0, which specifies that job output will be printed at any available local printer 
that was not assigned a route code by the PRINTERnn initialization parameter. 

PRIOINC=nn 

specifies a number (0-15) to be added to the selection priority of each job entered at this 
card reader. If the total of this number and a job's priority exceeds the priority level 
specified by PRIOLIM (described below), JES2 uses the priority level specified by 
PRIOLIM. 

Default: 

PRIOLIM=nn 

specifies the maximum priority level (0-15) that can be assigned to jobs entered at this 
card reader. If a job's priority (with or without the increment specified by PRIOINC) 
exceeds this level, it is reduced to this level. 



Default: 15 
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PRLCL/PRRMT 

PRLCL specifies that the route code specified by PRDEST is that of a local printer. 

Default: PRRMT, which specifies that the remote code is that of a remote printer. 

PUDEST=nnn 

specifies the default card punch destination for the punch output from jobs entered at 
this card reader that do not have a ROUTE statement or DEST parameter, nnn can be 
or it can be a route code (1-255) of a local card punch, as specified by the PUNCHnn 
parameter or of a remote card punch as specified by the RMTnnn parameter. If the route 
code is of a local punch, the PULCL option must be specified. 

Default: 0, which specifies that job output will be printed at any available local card 
punch that was not assigned a route code by the PUNCHnn initialization parameter. 

PULCL/ PURMT 

PULCL specifies that the route code specified by PUDEST is that of a local card punch. 

Default: PURMT, which specifies that the route code is that of a remote card punch. 

UNIT=cau 

specifies the unit address of this card reader. 

Default: If not specified, JES2 assigns the first available card reader address that is not 
already assigned. 



&RECINCR (Record 
Alternation) 



&RECINCR=n 

The &RECINCR parameter specifies the increment to be added to a spool record address 
to determine the address of the next record to be allocated on a track. It is also used to 
determine the addresses of all records in a track cell. 



The default setting of 2 indicates that records will be allocated in an alternating fashion 
to reduce rotational delay. For example, if &BUFSIZE is set to 1960 on a 3330 (6 
records per track), the default setting of &RECINCR will cause records to be allocated in 
the sequence: 1,3,5, 2, 4, 6. 

Note: Specifying a value other than the default value will affect the efficiency of the 
spool allocation algorithm. 

Lower Limit: 1 

Upper Limit: 8 

Default: 2 



&RJOBOPT (JOB Card 
Scan Option) 



&RJOBOPT=n 

The &RJOBOPT parameter specifies what type of scan should be performed on JOB 
cards that are processed by the JES2 input processor and whether an illegal JOB card is to 
prevent execution of the associated job. The allowable specifications for n have the 
following meanings: 
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Terminate 








on JES2 


Terminate 




Scan JES2 


Parameter 


on OS/VS2 


Value 


Parameters 


Error 


Format Error 





Yes 


Yes 


Yes 


1 


Yes 


Yes 


No 


2 


Yes 


No 


Yes 


3 


Yes 


No 


No 


4 


No 


- 


Yes 


5 


No 


. 


No 



The JOB card parameters CLASS, MSGCLASS, and TYPRUN are always scanned. The 
only other JES2 JOB card parameters scanned are those included in the JOB card 
accounting field as defined in the description of the Accounting Information parameter in 
OS/VS2JCL. 

If the value specified for this parameter is or 1 , the JOB card must have an accounting 
field subparameter and the first two JES2-defined parameters must be present. 

A JES2 parameter error is any violation of the requirements of the JES2 JOB card 
parameters. An MVS format error is any error which prevents JES2 from continuing the 
scan of the JOB card as defined in Chapter 4. 

Default: 2 



RMTnnn (BSC Remote 
Terminal) 



RMTnnn terminal type 

ABUFEX/ NOABUFEX 

BUFEX/ NOBUFEX 

COMP/ NOCOMP 

CONSOLE/ NOCON 

DISCINTV=n 

FIXED/ VARIABLE 

LINE=nnn 

MRF/ NOMRF 

MULTI/ HARDWARE 

NUMPR=n 

NUMPU=n 

NUMRD=n 

PASSWORD=cccccccc 

ROUTECDE=nnn 

TABS/ NOTABS 

TRANSP/ NOTRANSP 

UNBLOCK/ BLOCKED 

WAITIME=nn 



The RMTnnn parameter specifies the characteristics of one remote terminal. The 
descriptions given below apply to the characteristics of a BSC (binary synchronous 
communication) remote terminal. (For a description of the SNA remote terminal, see 
"RMTnnn (SNA Remote Terminal).") 

RMTnnn should be specified for each remote terminal. If not specified, JES2 assumes this 
is a basic 2770 terminal with no features. Remote terminals are numbered consecutively 
(RMT1-RMT255) for the number of remote terminals specified by the &NUMRJE 
parameter. 
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If a remote terminal has attached devices, use the following initialization parameters to 
describe their characteristics. 

Rnnn.PRm— specifies remote printer characteristics 
Rnnn.PUm— specifies remote card punch characteristics 
Rnnn.RDm— specifies remote card reader characteristics 

JES2 associates attached devices to a remote terminal by correlating the nnn in the above 
parameters to the nnn in an RMTnnn parameter. 

BSC remote terminal characteristics are specified by the following subparameters. 

terminal type 

is one of the following to specify the type of terminal or CPU at this remote location: 

2770 

2789 

3780 

2922 

M20-2 

M20-4 

M20-5 

M20-6 

S/360 

S/370 

1130 

System/3 

Default: 2770 

ABUFEX /NOABUFEX 

ABUFEX specifies that this (2770) terminal has the additional buffer expansion feature. 
ABUFEX can be specified even when BUFEX has not been specified for this terminal. 

Default: NOABUFEX, which specifies that this terminal does not have the additional 
buffer expansion feature. 

BUFEX /NOBUFEX 

BUFEX specifies that this (2770) terminal has the buffer expansion feature. 

Default: NOBUFEX, which specifies that this terminal does not have the buffer 
expansion feature. 

COMP/ NOCOMP 

COMP specifies that this (2770 or 3780) terminal has the compression/expansion feature. 

Default: NOCOMP, which specifies that this terminal does not have the compression/ 
expansion feature. 

CONSOLE/ NOCON 

CONSOLE specifies that this MULTI-LEAVING terminal has an operator console or that 
it is simulating a console as specified by the &PRTCONS RMT generation parameter. 

Default: NOCON, which specifies that this terminal has no operator console. 
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DISCINTV=nnnn 

specifies the interval (in seconds) after which, if there is no successful text transmission in 
either direction, this terminal will be disconnected from the processing unit. Error 
recovery tries and idle time are not counted as successful text transmission, nnnn may be 
from 1 to 8192 seconds; JES2 rounds this value to the next highest multiple of 30. 

Default: 0, which indicates that this terminal is not to be disconnected. 

FIXED/ VARIABLE 

FIXED specifies a fixed data record length for this terminal. 

Default: VARIABLE, which specifies a variable data record length. 

LINE=nnn 

specifies the number of the teleprocessing line that is connected (and dedicated) to this 
terminal. (The number of this line can not exceed the number of lines specified in the 
&NUMLNES parameter.) 

Default: If no line number is specified, JES2 assumes this is a nondedicated (SIGNON) 
line. 

MRF/ NOMRF 

MRF specifies that this 2780 terminal has the multiple record feature. 

Default: NOMRF, which specifies that this terminal does not have the multiple record 
feature. 

MULTI /HARDWARE 

MULTI specifies that this terminal will use the BSC (binary synchronous communication) 
MULTI-LEAVING interfaces. 

Default: HARDWARE, which specifies that this terminal will not use the BSC 
MULTI-LEAVING interfaces. 

NUMPR=n 

specifies the number (1-7) of printers at this remote terminal. Use the Rnnn.PRm 
initialization parameter to specify the characteristics of each printer. 

Default: 1 (If is specified, 1 is assumed.) 

NUMPU=n 

specifies the number (0-7) of card punches at this terminal. Use the Rnnn.PUm 
initialization parameter to specify the characteristics of each card punch. 

Default: 

NUMRD=n 

specifies the number (1-7) of card readers at this remote terminal. Use the Rnnn.RDm 
initialization parameter to specify the characteristics of each reader. 

Default: 1 (If is specified, 1 is assumed.) 

PASSWORD=cccccccc 

specifies a security password (1-8 characters) to prevent unauthorized terminals from 
using this remote terminal's resources. 
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Default: No password. 

ROUTECDE=nnn 

specifies the route code to be assigned to this terminal and its associated printers, 
punches, and readers, nnn may be any number from 1-999. 

Default: If a route code is not specified, JES2 assigns the number of this terminal 
(RMTnnn) as its route code. 

TABS/ NQTABS 

TABS specifies that this (2770, 2780, or 3780) terminal has the horizontal format 
control feature. 

Default: NOTABS, which specifies that this terminal does not have the horizontal format 
control feature. 

TRANSP /NOTRANSP 

TRANSP specifies that this terminal has the text transparency feature. To be effective, 
the TRANSP subparameter must also be specified for the line (LINEnnn initialization 
parameter) connected to this terminal. 

Default: NOTRANSP, which specifies that this terminal does not have the text 
transparency feature. 

UNBLOCK/ BLOCKED 

UNBLOCK specifies an unblocked data record format for this terminal. 

Default: BLOCKED, which specifies a blocked data record format. 

WAITIME=n 

specifies the length of time, from 1 to 30 seconds, that RTAM should wait at the 
completion of the processing of any input stream, or printed or punched output stream 
to allow the operator to enter an input stream at this remote terminal, n is a value greater 
than 0. 

Default: The value specified for the &WAITIME initialization parameter. 



RMTnnn (SNA Remote RMTnnn terminal type 

Terminal) BUFSIZE=nnnn 

COMP/ NOCOMP 
DISCINTV=nnnn 
FIXED/ VARIABLE 
LINE=nnn 
NUMPR=n 
NUMPU=n 
NUMRD=n 
PASSWORD=cccccccc 
ROUTECDE=nnn 
WAITIME=nn 



The RMTnnn parameter specifies the characteristics of one remote terminal. The 
descriptions given below apply to the characteristics of an SNA (^systems network 
architecture) remote terminal. (For a description of the BSC remote terminal, see 
"RMTnnn (BSC Remote Terminal).") 
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RMTnnn should be specified for each remote terminal. If not specified, JES2 assumes 
that this is a basic 2770 terminal with no features. Remote terminals are numbered 
consecutively (RMT1-RMT255) for the number of remote terminals specified by the 
&NUMRJE parameter. 

If a remote terminal has attached devices, use the following initialization parameters to 
describe their characteristics. 

Rnnri.PRm — specifies remote printer characteristics 

Rnnn.PUm — specifies remote card punch characteristics 

Rnnn.RDm — specifies remote card reader characteristics 

JES2 associates attached devices to a remote terminal by correlating the nnn in the above 
parameters to the nnn in an RMTnnn parameter. 

SNA remote terminal characteristics are specified by the following subparameters. 

terminal type 

specifies the type of terminal or CPU at this remote location. This subparameter must be 
specified as LUTYPE1 to indicate that this remote terminal is an SNA terminal (for 
example, a 3770 terminal or a System/32 workstation) that can be accessed only by 
means of a logical line (that is, a line defined by a LINEnnn parameter with the 
UNIT=SNA subparameter). 

Default: 2770 

BUFSIZE=nnnn 

specifies the largest request unit that can be sent to or received from this SNA terminal. 
nnnn must be in the range of 256 to the value specified for &TPBFSIZ. 

Default: 256 

COMP/ NOCOMP 

specifies that this terminal has the compression/expansion feature. All SNA terminals 
have this feature; but the default value, NOCOMP, can be used. 

Default: NOCOMP, which specifies that the terminal will not use the compression/ 
expansion feature. 

DISCINTV=nnnn 

specifies the interval (in seconds) after which, if there is no successful text transmission in 
either direction, JES2 terminates the session between the remote terminal and the 
processing unit. Error recovery tries and idle time are not counted as successful text 
transmission, nnnn may be from 1 to 8192 seconds. JES2 rounds this value to the next 
highest multiple of 30. 

Default: 0, which indicates that the session is not to be terminated and the terminal is 
not to be disconnected. 

FIXED/ VARIABLE 

FIXED specifies a fixed data record length for this terminal. 

Default: VARIABLE, which specifies a variable data record length. 
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LINE=nnn 

specifies the number of a logical line that is connected (and dedicated) to this terminal. 
(The number of this line cannot exceed the number of lines specified in the &NUMLNES 
parameter.) This line must be defined by a LINEnnn parameter with the UNIT=SNA 
subparameter specified. 

Default: If no line number is specified, JES2 assumes that this terminal is a nondedicated 
terminal, and can use any nondedicated line. 

NUMPR=n 

specifies number of printers at this terminal. SNA terminals can support only one printer 
and one printer data stream. Use the Rnnn.PRm parameter to specify the characteristics 
of this printer. 

Default: 1 

NUMPU=n 

specifies the number (0 or 1) of card punches at this terminal. SNA terminals can support 
only one punch data stream. Use the Rnnn.PUm initialization parameter to specify the 
characteristics of the card punch. 

Default: 

NUMRD=n 

specifies the number (0 or 1) of card readers at this remote terminal. SNA terminals can 
support only one reader data stream. Use the Rnnn.RDm initialization parameter to 
specify the characteristics of the reader. 

Default: 1 

PASSWORD=cccccccc 

specifies a security password (1-8 alphanumeric or national characters) to prevent 
unauthorized terminals from using this remote terminal's resources. 

Default: No password. 

ROUTECDE=nnn 

specifies the route code to be assigned to this terminal and its associated printers, 
punches, and readers, nnn may be any number from 1-999. 

Default: If a route code is not specified, JES2 assigns the number of this terminal 
(RMTnnn) as its route code. 

WAITIME=nn 

specifies the length of time, 1 to 30 seconds, that RTAM should wait at the completion 
of the processing of any input stream, printed output stream, or punched output stream 
to allow the operator to enter an input stream at this remote terminal. 

Default: The value specified for the &WAITIME initialization parameter. 



Chapter 3. JES2 Initialization 69 



Rnnn.PRm (Remote RnnnJPRm AUTO/ OPERATOR 

Printer) CLASS=C! . . . c n 

DRAIN/ START 
FCB=cccc 

FCBLOAD/ NOFCBLOD 
FORMS=cccc 
NOSEP/SEP 
NOSUSPND/ SUSPEND 
PRWIDTH=nnn 
ROUTECDE=nnn 
UCS=cccc 



The Rnnn.PRm parameter specifies the characteristics of one printer at a remote 
terminal, nnn is the number of a remote terminal as specified in the RMTnnn, parameter 
and m is the number of this printer. Printers are numbered consecutively (Rnnn.PRl to 
Rnnn.PR7) for the number of printers specified (NUMPR=n in the RMTnnn parameter) 
for this remote terminal. For example, if there are three printers attached to remote 
terminal number 28, the printers are numbered R28.PR1 , R28.PR2, and R28.PR3. 

Characteristics for remote printers are specified by the following subparameters. 

AUTO/ OPERATOR 

AUTO specities that this printer is initially to operate in automatic (demand) forms mode 
when JES2 starts processing. 

Note: Except for SNA terminals, printers connected to terminals without MULTI- 
LEA VING support should be operated in operator-controlled mode. 

Default: OPERATOR, which specifies that this printer is initially to operate in 
operator-controlled (forms) mode. 

CLASS=C! . . . c n 

specifies the output classes, in priority sequence, to be processed by this printer. You can 
specify any number of classes (A-Z,0-9) up to the maximum number of classes specified 
by the &NUMCLAS parameter. 

Default: AJ 

DRAIN/ START 

DRAIN specifies that this printer is to be started by operator command. 

Default: START, which specifies that this if it is ready) is to be automatically started 
when JES2 starts processing. 

FCB=cccc 

specifies the forms buffer image or the carriage control tape that is to be initially 
mounted On this printer, cccc is the forms control buffer (FCB) identifier (1 to 4 
alphanumeric characters) that resides in SYS1.IMAGELIB. (Refer to OS/VS2 System 
Programming Library: Data Mangement for information on how to add FCBs to 
SYS1.IMAGELIB.) 

Default: The identifier specified by the &PRTFCB parameter. 

FCBLOAD/ NOFCBLOD 

FCBLOAD specifies that FCB support is to be provided for this printer. 
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Note: FCBLOAD is effective only if this is a 3211 printer attached to a S/360 or S/370 
(not including M/20) CPU which has the text transparency feature (TRANSP specified 
for both the LINEnnn and the RMTnnn parameters), or if this printer is an SNA terminal 
(FCBLOAD for an SNA terminal uses only one stop per channel for a maximum of 
twelve stops). Also, the length of FCB images that can be used for this printer cannot 
exceed the line length specified for this printer (PRWIDTH) minus 2. 

Default: NOFCBLOD, which specifies that no FCB support is to be provided for this 
printer. 

FORMS=cccc 

specifies the forms identifier (1 to 4 alphanumeric characters) of the forms that are to be 
loaded initially in this printer. 

Default: If no value is specified, JES2 uses the forms identifier specified by the 
&STDFORM parameter. 

NOSEP/SEP 

NOSEP specifies that separator pages are not to be provided initially between data set 
groups. (Separator pages can be specified later by operator command.) NOSEP also 
suppresses printing of operator messages. 

Default: SEP, which specifies that separator pages are to be provided initially between 
data set groups. 

Note: // a zero number of print lines was specified by the &TPIDCT parameter, 
separator pages will not be produced even if SEP is specified. 

NOSUSPND/ SUSPEND 

NOSUSPND specifies that this printer is not to use the printer interrupt feature. This 
feature allows the remote operator to interrupt printing to transmit jobs or JES2 
commands to JES2. 

Default: SUSPEND, which specifies that this printer is to use the printer interrupt 
feature. 

Note: This parameter is ignored for printers that are connected to terminals without 
MULTI-LEAVING support, including SNA terminals. 

PRWIDTH=nnn 

specifies the maximum number of characters to be printed on one line. 

Note: This value must not exceed the printer width you specified during RMT generation 
of this MULTI-LEAVING terminal (with the &PRTSIZE parameter for Mod 20, S/360, 
and S/370 terminals and via the &PRFOTLW parameter for 1130 terminals). 

Default: 120 

ROUTECDE=nnn 

specifies the route code, 1 to 255, to be assigned to this printer. The route code specified 
may be that of any remote terminal defined to JES2 by means of an RMTnnn 
initialization parameter. 

Default: JES2 assigns the route code of the remote terminal to which the printer is 
attached. (See the description of the RMTnnn parameter for more information about the 
route code.) 
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UCS=cccc 

specifies the print train (or print chain) that is initially mounted on this printer. 

Default: The identifier specified by the &PRTUCS parameter. 



Rnnn.PUm (Remote Card Rnnn.PUm AUTO/ OPERATOR 
Punch) CLASS=Ci . . . c n 

DRAIN/ START 
FORMS=cccc 
NOSEP/SEP 
NOSUSPND/ SUSPEND 
ROUTECDE=nnn 



The Rnn.PUm parameter specifies the characteristics of one card punch at a remote 
terminal, nnn is the number of a remote terminal as specified in the RMTnnn parameter 
and m is the number of this card punch. Card punches are numbered consecutively 
(Rnnn.PUl to Rnnn.PU7) for the number of card punches specified (NUMPU=« in the 
RMTnnn parameter) for this remote terminal. For example, if there are two punches 
attached to remote terminal number 14, the punches are numbered R14.PU1 and 
R14.PU2. 

Characteristics for remote punches are specified by the following subparameters. 

AUTO/ OPERATOR 

AUTO specifies that this card punch is to initially operate in automatic (demand) forms 
mode when JES2 starts processing. 

Note: Except for SNA terminals, punches connected to terminals without MULTI- 
LEA VING support must be operated in operator-controlled mode. 

Default: OPERATOR, which specifies that this punch is initially to operate in 
operator-controlled (forms) mode. 

CLASS=Ci ...c n 

specifies the output classes, in priority sequence, to be processed initially by this card 
punch. You can specify any number of classes (A-Z,0-9) up to the maximum number of 
classes specified by the &NUMCLAS parameter. 

Default: BK 

DRAIN/ START 

DRAIN specifies that this card punch is to be started by operator command. 

Default: START, which specifies that this punch (if it is ready) is to be automatically 
started when JES2 starts processing. 

FORMS=cccc 

specifies the forms identifier (1 to 4 alphanumeric characters) of the forms that are to be 
loaded initially in this card punch. 

Default: JES2 uses the identifier specified by the &STDFORM parameter. 

NOSEP/SEP 

NOSEP specifies that separator cards are not to be provided initially between data set 
groups. (Separator cards can be specified later by operator command.) 
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Default: SEP, which specifies that separator cards are to be provided initially between 
data set groups. 

NOSUSPND/SUSPEND 

NOSUSPND specifies that this card punch is not to use the punch interrupt feature. This 
feature allows the remote terminal operator to interrupt punching to transmit jobs or 
JES2 commands to JES2. 

Default: SUSPEND, which specifies that this card punch is to use the punch interrupt 
feature. 

Note: This parameter is ignored for punches that are attached to terminals without 
MULTI-LEAVING support, including SNA terminals. 

ROUTECDE=nnn 

specifies the route code, 1 to 255, to be assigned to this punch. The route code specified 
may be that of any remote terminal defined to JES2 by means of the RMTnnn 
initialization parameter. 

Default: JES2 assigns the route code of the remote terminal to which the punch is 
attached. (See the description of the RMTnn parameter for more information about the 
route code.) 



Rnnn.RDm (Remote Card Rnnn.RDm CLASS=c 
Reader) DRAIN/ START 

HOLD/ NOHOLD 
MSGCLASS=c 
PRDEST=nnn 
PRIOINC=nn 
PRIOLIM=nn 
PRLCL/ PRRMT 
PUDEST=nnn 
PULCL/PURMT 



The Rnnn.RDm parameter specifies the characteristics of one card reader at a remote 
terminal, nnn is the number of the remote terminal as specified in the RMTnnn parameter 
and m is the number of this reader. Readers are numbered consecutively (Rnnn.RDl to 
Rnnn.RD7) for the number of readers (NUMRD=« in the RMTnnn parameter) specified 
for this remote terminal.. For example, if there are three card readers attached to remote 
terminal 2, the readers are numbered R2.RD1, R2.RD2, and R2.RD3. 

Characteristics for remote readers are specified by the following subparameters. 

CLASS=c 

specifies the job class to be assigned to all jobs entered at this card reader that do not 
specify a job class in the CLASS operand of their JOB statements, c can be any class 
A-Z,0-9. 

Default: A 

DRAIN/ START 

DRAIN specifies that this card reader is to be started by operator command. 

Default: START, which specifies that this card reader is to start automatically when 
JES2 starts processing. 
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HOLD/ NOHOLD 

HOLD specifies that all jobs entered at this card reader are to be held after JCL 
conversion until they are released for execution by the operator. 

Default: NOHOLD, which specifies that jobs entered at this card reader are to be queued 
as usual. 

MSGCLASS=c 

specifies the message class to be assigned to jobs entered at this card reader that do not 
specify a MSGCLASS operand in their JOB statements, c can be any class (A-Z,0-9). 

Default: A 

PRDEST=nnn 

specifies the printer destination for the printed output from all jobs that are entered at 
this card reader that do not have a ROUTE statement or DEST parameter, nnn can be 
or it can be a route code (1-255) of a local printer or a remote printer as specified by the 
PRINTERnn or RMTnn parameter, respectively. If the route code is of a local printer, 
than the PRLCL option must be specified. When is specified, job output is printed at 
any available local printer that was not assigned a route code by the PRINTERnn 
parameter. 

Default: The route code (ROUTECDE) specified in the RMTnnn parameter for this 
remote terminal. 

PRIOINC=nn 

specifies a number (0 to 15) to be added to the selection priority of each job entered at 
this card reader. If the total of this number and a job's priority exceeds the priority level 
specified by PRIOLIM, JES2 uses the priority level specified by PRIOLIM. 

Default: 

PRIOLIM=nn 

specifies the maximum priority level (0 to 15) that can be assigned to jobs entered at this 
card reader. If a job's priority (with or without the increment specified by PRIOINC) 
exceeds this level, it is reduced to this level. 

Default: 15 

PRLCL/ PRRMT 

PRLCL specifies that the route code specified by PRDEST is that of a local printer. 

Default: PRRMT, which specifies that the route code is that of a remote printer. 

PUDEST=nnn 

specifies the card punch destination for the punched output from jobs entered at this 
card reader that do not have a ROUTE statement or a DEST parameter, nnn can be or 
it can be a route code (1-255) of a local card punch or a remote card punch as specified 
by the PUNCHnn or RMTnnn parameter, respectively. If the route code is of a local card 
punch, the PULCL option must be specified. When is specified, job output is printed at 
any available local card punch that was not assigned a route code by the PUNCHnn 
parameter. 

Default: PUDEST=0 
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PULCL/PURMT 

PULCL specifies that the route code specified by PUDEST is that of a local card punch. 



&RPRBOPT (Remote 
Printer Double Buffering 
Option) 



&RPRI(n) (Job 
Execution Selection 
Priority) 



Default: PURMT, which specifies that the route code is that of a remote card punch. 

&RPRBOPT= YES/NO 

The &RPRBOPT parameter specifies whether or not double buffering is to be used for 
remote printers. If NO is specified, single buffering is used. 

Note: The specification refers to JES2 regular I/O buffers, not to JES2 teleprocessing 
buffers. 

Default: NO 

&RPRI(n)=nn 

The &RPRI(n) parameter specifies job scheduling priorities that are associated with 
execution times as specified in a corresponding &RPRT(n) parameter. If these parameters 
are not specified, the following values are used as default values: 

&RPRI(1)=9 
&RPRI(2)=8 
&RPRI(3)=7 
&RPRI(4)=6 
&RPRI(5)=5 
&RPRI(6)=4 
&RPRI(7)=3 
&RPRI(8)=2 
&RPRI(9)=1 

If a /*PRIORITY control card is not supplied with a job or if PRTY is not specified on 
the JOB card, the priority of that job is determined as follows: 

The queuing priority is computed as: 
priority = (&RPRI(n) + &XPRI(m))*2 

The subscript n is the smallest number for which: 
t < &RPRT(n) 

The subscript m is the smallest number for which: 
o < &XLIN(m) 

where: 



is the estimated execution time, taken from the accounting field of the JOB card or from 
the /*JOBPARM control card. 



is the sum of the estimated output lines and cards, taken from the accounting field of the 
JOB card or from the /*JOBPARM control card. 

Refer to the &RPRT(n) and the &XPRI(n) parameters for additional information. 
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Lower Limit: 

Upper Limit: 15 

Default: Refer to the list of default values given above. 



&RPRT(n) (Job Execution &RPRT(n)=nnnnnn 
Time Priority Categories) 



The &RPRT(n) parameter specifies execution times that are to be associated with job 
scheduling priorities as specified in a corresponding &RPRI(n) parameter. If these 
parameters are not specified, the following are used as default values: 

&RPRT(1)=2 

&RPRT(2)=5 

&RPRT(3)=15 

&RPRT(4)=279620 

&RPRT(5)=279620 

&RPRT(6)=279620 

&RPRT(7)=279620 

&RPRT(8)=279620 

&RPRT(9)=279620 

If a /*PRIORITY control card is specified for a job, these values are not used. 

Refer to the &RPRI(n) and &XPRI(n) parameters for additional information. 

Lower Limit: 1 

Upper Limit: 279620 (that is, approximately X'FFFFFF'/60) 

Default: Refer to the list of default values given above. 



&RPS (Rotation Position 
Sensing Support Option) 



&RPUBOPT (Remote 
Punch Double 
Buffering Option) 



&RPS=YES/NO 

The &RPS parameter specifies whether or not to include rotational position sensing for 
JES2 channel programs directed to direct-access devices with the rotational position 
sensing feature. 

JES2 operates with any supported direct-access device or combination of devices, 
regardless of the specification of this parameter. 

Default: YES 
&RPUBOPT=YES/NO 

The &RPUBOPT parameter specifies whether or not double buffering is to be used for 
remote card punches. If NO is specified, single buffering is used. 

Note: The specification refers to JES2 regular I/O buffers, not to JES2 teleprocessing 
buffers. 

Default: NO 
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&SID (System ID) 



&SID=cccc 



The &SID parameter specifies a four-character alphanumeric system ID to be used in 
place of that provided by SMF. This parameter may be required to warm-start JES2 on a 
system with a different SMF-defined system ID, or to warm start JES2 on the same 
system following an IPL with different SMF specifications. In any case, for a JES2 warm 
start, this specification must match that last used in starting JES2. 

Default: The SMF-provided system ID. 



Sn (System ID in a 
Multi-Access Spool 
Configuration) 



Sn SID=ccc 

The Sn parameter is required to identify each system in a multi-access spool 
configuration. The initialization data set for each system must contain the Sn parameters 
of all the systems in the configuration. That is, if there are three systems (K158, L158, 
LI 68) in the configuration, the initialization data set for each system would contain the 
following parameters: 

51 SID=K158 

52 SID=L158 

53 SID=L168 



Systems are numbered consecutively from one to seven (S1-S7). The system identifier is 
specified by the following subparameter. 

SID=cccc 

specifies the system identifer. cccc is the four-character alphanumeric name that was 
generated as the system management facility (SMF) system ID for this system. 

Default: For a single system configuration, the system identifier for SI defaults to the 
generated SMF system ID. For multi-access spool configurations, the system IDs must be 
specified for each system and no default is permitted. 



&SPOLMSG (Remote 
Terminal Spool 
Message Record Count) 



&SPOLMSG=nnn 

The &SPOLMSG parameter specifies the number of physical records (in the first extent 
of SYS1. HASP ACE on the primary spool volume) to be reserved for operator messages 
and JES2 messages for each JES2 remote terminal. Total space reserved is 
&SPOLMSG*&NUMRJE. Each physical record is capable of holding one or more 
messages for a single remote terminal. Messages are held if they are directed to: 

• Any terminal not signed on, or 

• Any signed-on computer terminal that is not a MULTI-LEAVING terminal with a 
console 



Space for each terminal is separate from that of other terminals. Each message to a 
terminal (except to a MULTI-LEAVING remote terminal with a console) is held until it 
can be printed or until JES2 is cold-started. If a message is to be held and the terminal's 
space is filled, the oldest held messages for that terminal are discarded without operator 
notification. 

Only the $DMR command can generate messages to a terminal that is not signed on. For 
signed-on terminals, messages are generated for job-on-reader, by the $DMR command, 
and as responses to commands from the terminal. 
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&SPOOL (Spool 
Volume ID) 



Lower Limit: 

Upper Limit: 254 

Default: (4096 + &BUFSIZE) X.6 

&SPOOL=cccccc 

The &SPOOL parameter specifies the volume serial number of the primary spool volume. 
Any six characters that define a valid volume serial number may be used. (This is a change 
from HASP where you specified only the first five characters of the primary spool volume 
ID.) 

Wheh you define the spool volumes, the first five characters of the volume serial number 
of each volume must be identical to the- first five characters specified in this parameter. 
The sixth character can be any character that is valid in a volume serial number, including 
a blank. 

One volume must be designated as the primary spool volume. All six characters of its 
volume serial number must agree with the six characters specified in this parameter. 

Note: If a value other than SPOOL1 is specified, certain messages will vary from their 
documentation in OS/VS Message Library: VS2 System Messages. 

Default: SPOOL1 



&STC, &TSU, &x 
(Job Class) 



{&STC) CONVPARM=bppmmmmsscccrlaaaaef 
&TSU> COPY/ NOCOPY 
&x J HOLD/ NOHOLD 

NOJOURN/ JOURNAL 

NOLOG/ LOG 

NOOUTPUT/ OUTPUT 

NOTYPE6/ TYPE6 

NOTYPE26/ TYPE26 

NOUJP/ IEFUJP 

NOUSO/ IEFUSO 

PERFORM=nnn 

PROCLIB=nn 

RESTART/ NORESTRT 

SCAN/ NOSCAN 

XBATCH/ NOXBATCH 

The &STC,&TSU, and &x parameters specify the characteristics to be associated with 
one job class. Job classes are specified as follows: 

&STC— defines the job class for started tasks 
&TSU— defines the job class for time sharing users 
&x— defines any batch class (A-Z,0-9) 

Job class characteristics are specified by the following subparameters. 

CONVPARM=bppmmmmsscccrlaaaaef 

specifies the default parameters to be used by the OS/VS2 Converter to process jobs in 
this job class. The parameters are specified by 20 hexadecimal characters. For a 
description of the parameters, refer to the &RDROPSU parameter. 
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Default: If the CONVPARM subparameter is not specified, the converter uses the 
parameters specified in the following parameters: 

&RDROPSL, for the time-sharing user job class 
&RDROPST, for the started task job class 
&RDROPSU, for background job classes 

COPY/ NOCOPY 

COPY specifies that jobs in this job class are to be queued for output processing as 
though TYPRUN=COPY was specified on the JOB statement for these jobs. 

Default: NOCOPY, which specifies that jobs in this job class are to be queued as usual. 
NOCOPY will be ignored if the TYPRUN=COPY parameter is specified on the JOB 
statement for a job. 

HOLD /NOHOLD 

HOLD specifies that jobs in this job class are to be held until a RELEASE command is 
issued by the operator. 

Default: NOHOLD, which specifies that jobs in this job class are to be queued as usual. 
NOHOLD will be ignored if the TYPRUN=HOLD parameter is specified on the JOB 
statement for a job (or if the job is held for other reasons). 

NOJOURN/ JOURNAL 

NOJOURN specifies that information for the job journal is not to be processed for a job 
in this job class unless: 

RD=R or RD=RNC is specified on the JOB card. 

No RD parameter appears on the job card, but RD=R or RD=RNC is specified on any 
of the EXEC cards for the job. 

Note that the job journal contains checkpoint/restart information. Jobs that are not 
recorded in the job journal cannot be automatically restarted or warm-started. 

Default: JOURNAL, which specifies that information for the job journal is to be 
processed for this job class. 

NOLOG/LOG 

NOLOG specifies that the JES2 job log is not to be printed for this job class. The JES2 
job log contains the user's console messages and replies to WTORs issued during the 
processing of the job. When NOLOG is specified, JES2 statistics information, normally 
printed with the job, is also suppressed. 

Default: LOG, which specifies that the job log is to be printed for this job class. Even 
when LOG is specified, the job log may be suppressed, for individual jobs by using a 
parameter in the accounting field of the JOB card or via a parameter on a JOBPARM 
control card. 

NOOUTPUT/ OUTPUT 

NOOUTPUT specifies that no SYSOUT data is to be written for jobs executed in this job 
class. 

Default: OUTPUT, which specifies that SYSOUT data is to be written for jobs executed 
in this job class. 
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NOTYPE6/ TYPE6 

N0TYPE6 specifies that JES2 is not to produce type 6 SMF (external writer) records for 
jobs in this job class. Type 6 SMF records are written for each group of job-related data 
sets and each spin-off data set that is processed. Type 6 records are described in OS/VS2 
System Programming Library: System Management Facilities (SMF). 

Default: TYPE6, which specifies that JES2 is to produce type 6 SMF records for this job 
class. When type 6 records are to be produced, the &NUMSMFB parameter must specify 
two or more SMF buffers. 

Note: Specifying TYPE6 has no effect for the &STC parameter which assumes the 
NOTYPE6 option. 

NOTYPE26/ TYPE26 

NOTYPE26 specifies that JES2 is not to produce type 26 (job summary) SMF records for 
jobs in this job class. Type 26 records are described in OS/VS2 System Programming 
Library :.System Management Facilities (SMF). 

Default: TYPE26, which specifies that JES2 is to produce type 26 SMF records for jobs 
in this job class. When type 26 records are to be produced, the &NUMSMFB parameter 
must specify two or more SMF buffers. 

Note: Specifying TYPE26 has no effect on the &STC parameter, which assumes the 
NOTYPE26 option. 

NOUJP/ IEFUJP 

NOUJP specifies that the IEFUJP exit is not to be taken when a job is purged. IEFUJP 
receives control when a job is ready to be purged from the system; that is, after the job 
has been terminated and all the SYSOUT output that pertains to the job has been 
processed. 

Default: IEFUJP, which specifies that the IEFUJP exit is to be taken when a job is 
purged. 

Note: Specifying IEFUJP has no effect on the &STC parameter, which assumes the 
NOUJP option. 

NOUSO/ IEFUSO 

NOUSO specifies that the IEFUSO user exit is not to be taken when the SYSOUT limit is 
reached for a job in this job class. The SYSOUT limit, which is specified by the OUTLIM 
parameter on the JOB card, defines the maximum number of physical records to be 
written to the associated SYSOUT data set. When the OUTLIM value is exceeded, JES2 
normally calls the IEFUSO SMF exit routine to either increase the SYSOUT limit or to 
terminate the job. When NOUSO is specified and OUTLIM is exceeded, JES2 abnormally 
terminates the job. 

Default: IEFUSO, which specifies that the IEFUSO user exit is to be taken when the 
SYSOUT limit is reached for a job in this job class. 

Note: IEFUSO has no effect on the &STC parameter which assumes the NOUSO option. 

PERFORM=nnn 

specifies the performance group number for this job class when a performance group 
number is not specified on the JOB or EXEC control statement for a job of this job class. 
Any decimal number from 0-255 can be specified. 
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Default: 0, which indicates that no performance group processing will be performed by 
JES2 and causes the Workload Manager to assign a default value (1 for background jobs 
and 2 for foreground jobs) and issue an error message. 

PROCLIB=nn 

specifies the default procedure library number which is to be used for this job class. It 
allows you to specify different procedure libraries for different job classes. In the JES2 
procedure, one DD statement must be named PROC00. If you specify additional 
procedure libraries (01-99) at that time, you may associate these libraries to a job class by 
replacing the nn of this subparameter with the appropriate procedure library number. 

Note: All cataloged procedure libraries to be used by jobs, time-sharing users, or system 
tasks must be defined in the JES2 procedure. 

Default: 00 

RESTART /NORESTRT 

RESTART specifies that JES2 is to queue for reexecution from the beginning any job of 
this job class that was executed before a system re-IPL and JES2 warm start, unless the 
job can be restarted from a step or checkpoint by the system. 

If JOURNAL is specified, jobs in this job class can normally be restarted from a step or 
checkpoint. If RESTART and NOJOURN are both specified, JES2 always attempts to 
restart interrupted jobs in this class from the beginning. If RESTART is specified together 
with JOURNAL, JES2 restarts interrupted jobs from the beginning only if the system is 
unable to restart the job from a step or checkpoint. 

Specifying RESTART=Y or RESTART=N on the /*JOBPARM control statement for a 
particular job overrides the job class RESTART subparameter. 

Default: NORESTRT, which specifies that JES2 is not to take special action to restart 
jobs in this class that were being executed before a system re-IPL and JES2 warm start. 

SCAN/ NOSCAN 

SCAN specifies that jobs in this job class are to be queued for output processing 
immediately after JCL conversion as though TYPRUN=SCAN was specified on the JOB 
statement for these jobs. 

Default: NOSCAN, which specifies that jobs in this job class are to be queued as usual. 
NOSCAN will be ignored if the TYPRUN=SCAN parameter is specified on the JOB 
statement for a job. 

XBATCH/ NOXBATCH 

XBATCH specifies that the Execution Batch Scheduling feature is to be associated with 
this job class. (This feature is described for JES2 in the chapter "JES2 Processing.") 

Default: NOXBATCH, which specifies that the Execution Batch Scheduling feature is 
not to be associated with this job class. 



STCMCLAS (Message STCMCLAS=c 

Class for Started Tasks) 



The STCMCLAS parameter specifies the message class for all started tasks. All job control 
statements and system messages will be assigned to this class. The specification can be any 
valid message class (A-Z,0-9). 
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Default: A 



&STDFORM (Default 
Forms ID) 



&STDFORM=cccc 

The &STDFORM parameter specifies an identifier, four alphanumeric characters, that is 
used as a forms ID when a forms ID is not specified. It also specifies the default initial 
setup of all printers and punches at JES2 initialization. 

Default: STD. 



&SYNCTOL (Synchroni- 
zation Tolerance) 



&TCELSIZ (Track Cell 
Size) 



&SYNCTOL=nnn 

The &SYNCTOL parameter specifies, in seconds, the time interval that must elapse 
before one JES2 system in a multi-access spool configuration is assumed to be not 
operating. This parameter allows for imprecise synchronization of TOD clocks (caused by 
human intervention) in a multi-access Spool environment. 

Actions such as a cold start, warm start, or $ESYS operator command are rejected unless 
the time stamps of affected systems in the shared checkpoint record are less than the 
current time minus this parameter. 

Lower Limit: 

Upper Limit: 300 (5 minutes) 

Default: 120 (2 minutes) 

&TCELSIZ=nnn 

The &TCELSIZ parameter specifies the size of a track cell in terms of spool buffers; that 
is, &TCELSIZ specifies the number of direct access spool records to be logically ordered 
on a spool track and the number of records to be despooled in one operation during print 
processing. 

Note: A data set uses the track-cell method only if the SYSOUT class of the data set has 
the TRKCEL characteristic (refer to the description of the $$x initialization parameter). 
Similarly, track cells, rather than single buffers, are despooled during print processing 
only if the printer is defined with the DSPLTCEL characteristic (refer to the description 
of the PRINTERnn initialization parameter). 

If &TCELSIZ is greater than the number of records on a track of a spool volume, the 
entire track is considered a track cell. If &TCELSIZ is less than or equal to the number of 
records on a track of a spool volume, the track is divided into as many track cells as will 
fit evenly. 

The records remaining after this division, if any, are used as follows: 

• If the number of remaining records is greater than or equal to one-half the &TCELSIZ 
value, the records are available to any data set (with or without the track-cell 
characteristic). 

• If the number of remaining records is less than one-half the &TCELSIZ value, the 
records are available only for data sets without the track-cell characteristic. 

Lower Limit: 1 
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&TGWARN (Threshold 
Spool Utilization) 



&TIMEOPT (Execution 
Time Monitoring Option) 



&TIMEXS (Exceeded 
Execution Time Message 
Interval) 



&TPBFSIZ (Teleprocess- 
ing Buffer Size) 



Upper Limit: 111 
Default: 3 

&TGWARN=nnn 

The &TGWARN parameter specifies the threshold percentage use of spool space that 
causes the message $HASP093 xxx% SPOOL UTILIZATION to be issued by JES2. A 
value of indicates that every use of spool space will be reported, and a value of 101 
indicates that no message will be issued. 

Lower Limit: 

Upper Limit: 101 

Default: 80 

&TIMEOPT= YES/NO 

The &TIMEOPT parameter specifies whether or not to support the elapsed time job 
monitor feature of JES2. 

If YES is specified, the operator is informed when a job's estimated execution time is 
exceeded and notified periodically thereafter. 

Refer to the &ESTIME and &TIMEXS parameters for additional information. 

Default: NO 

&TIMEXS=nn 

The &TIMEXS parameter specifies, in minutes, the interval at which messages will be 
written to inform the operator that a job's execution time is exceeded. The first message 
is written to the operator when the job's estimated time has been exceeded. 

If the &TIMEOPT parameter is specified as NO, this parameter is ignored. 

Lower Limit: 1 

Upper Limit: 30 

Default: 1 

&TPBFSIZ=nnnn 

The &TPBFSIZ parameter specifies, in bytes, the size of the JES2 teleprocessing buffers. 
The value specified must be a multiple of 8 and be greater than or equal to the value 
specified for &MLBFSIZ. If it is not, it is automatically rounded up without notice. 

When SNA RJE terminals are supported, this value is increased, if neccessary, without 
notice to the largest &BUFSIZE value specified for an SNA remote terminal. 
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The following table gives minimum values required to support various non-programmable 
terminals. 



&TPIDCT (Remote 
Printer Separator Page 
Line Count) 



TSUMCLAS (TSO 
Message Class) 



&WAITIME (Remote 
Terminal Function 
Interval) 



Minimum 
&TPBFSIZ 

264 
400 
516 
516 
256 



Terminal Type, Features 

2770 with buffer expansion 

2780 

2770 with buffer expansion and additional buffer expansion 

3780 

LUTYPE1 



Note: // necessary, the value specified for &TPBFSIZ will be increased without notice to 
the appropriate minimum value indicated in the table above if RMTnnn initialization 
parameters are specified for the above terminal types with the indicated features. 

Lower Limit: 128 

Upper Limit: 3976 (dependent on the JES2 macro expansions) 

Default: 400 

&TPIDCT=nnn 

The &TPIDCT parameter specifies the number of print lines that are to appear on each 
JES2 job separator page for printed output for remote terminal printers. If the 
specification is 30 or greater, the first 29 lines are used to produce a block-lettered job 
name, job number, and SYSOUT class. 

The equivalent parameter for local terminal printers is &PRIDCT. 

Lower Limit: 

Upper Limit: 255 

Default: 6 

TSUMCLAS=c 

The TSUMCLAS parameter specifies the message class for all time-sharing foreground 
jobs. It also specifies the default message class for all background jobs submitted from a 
time-sharing session. The specification can be any valid message class (A-Z,0-9). 

Default: A 

&WAITIME=nn 

The &WAITIME parameter specifies, in seconds, the length of time that JES2 should wait 
at the completion of the processing of any input stream, printed output stream, or 
punched output stream, to allow the operator to alter the normal sequence of RJE 
operations. For example, the operator may want to transmit another job to JES2 after a 
previous job has finished printing, rather than wait until all queued output has finished 
processing. 

Lower Limit: 1 
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Upper Limit: 30 
Default: 1 

&WARNTIM (Lock-Out &WARNTIM=nnnnn 
Warning Time) 



The &WARNTIM parameter specifies, in hundredths of a second, the time interval from 
the first denied request for access to the shared queues of a member of a multi-access 
spool configuration to the time that that configuration will assume the member 
controlling the queues to be down. When this situation occurs, JES2 issues the HASP260 
message, indicating a lock-out situation, and resets the timer interval to the &WARNTIM 
value. 

Lower Limit: 500 (5 seconds) 

Upper Limit: 15000 (2 1/2 minutes) 

Default: 1000 (10 seconds) 



$$x (SYSOUT Class) $$x DUMMY/ SYSOUT 

HOLD/ NOHOLD 
PUNCH/ PRINT 
TRKCEL/ NOTRKCEL 



This parameter specifies the SYSOUT class characteristics for one output class, x can be 
any one of the 36 (A-Z,0-9) possible output classes. 

DUMMY/ SYSOUT 

DUMMY specifies that JES2 is to process this output class as a dummy data set (like a 
DD DUMMY statement). 

Default: SYSOUT specifies that JES2 is to process this output class as SYSOUT. 

HOLD/ NOHOLD 

HOLD specifies that data sets specifying this SYSOUT class are to be eligible to be held 
for TSO SYSOUT processing. The class specified on the MSGCLASS parameter should be 
either the same class or another class that is also defined with $$x HOLD. 

Note: The only other way to specify that a data set is to be held is by specifying the 
HOLD=YES parameter on the data definition (DD) control statement that defines the 
SYSOUT data set. In this case, the data set will be held even though NOHOLD is 
specified for this subparameter. 

Default: NOHOLD, which specifies that these data sets are not to be held for TSO user 
processing. 

PUNCH/ PRINT 

PUNCH specifies that this output class is normally to be punched. 

Default: PRINT, which specifies that this output class is normally to be printed. For 
classes B and K, the default is PUNCH. 

Note: Any class may be specified for either print or punch. The purpose of this 
subparameter is to define the installation's standard for output classes so that appropriate 
print and punch accounting can be maintained. 
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TRKCEL/ NOTRKCEL 

TRKCEL specifies that physical records of each data set of this SYSOUT class are to be 
specially grouped on the spool volume(s), and are to be written to and read from the 
spool volume in blocks. (Refer to the &TCELSIZ initialization parameter for additional 
information.) 

Default: NOTRKCEL, which specifies that physical records are to be written and read 
individually. 



&XBATCH (Execution 
Batch Scheduling Option) 



&XBATCHN (Execution 
Batch Scheduling 
Procedure Prefix) 



&XLIN(n) (Output 
Selection Priority 
Category) 



&XBATCH=YES/NO 

The &XBATCH parameter specifies whether or not to support the JES2 execution batch 
scheduling feature. 

Default: NO 

&XBATCHN=ccccc 

The &XBATCHN parameter specifies the first five characters of the name of each MVS 
program or procedure to be started internally by JES2 when required to execute a user 
job under the execution batch scheduling feature. The specification must be a 
five-character alphanumeric name whose first character is alphabetic or national. 

If the &BATCH parameter is specified, JES2 rejects all user-submitted Jobs whose job 
names begin with the five characters specified in this parameter. 

Default: $$$$$ 

&XLIN(n)=nnnnnnnn 

The &XLIN(n) parameter specifies the output record counts that are associated with the 
priorities as specified in the &XPRI(n) parameter. If this parameter is not specified, the 
following are used as default values: 

&XLIN(1)=2000 
&XLIN(2)=5000 
&XLIN(3)=15000 

&XLIN(4)= 167772 15 
&XLIN(5)=16777215 
&XLIN(6)=16777215 
&XLIN(7)=16777215 
&XLIN(8)= 167772 15 
&XLIN(9)=16777215 

If a /*PRIORITY control card is specified, these values are not used. 

Refer to the &RPRT(n) and &XPRI(n) parameters for additional information. 

Lower Limit: 1 

Upper Limit: 16777215 (that is, X'FFFFFF') 

Default: Refer to the list of default values given above. 
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&XPRI(n) (Output &XPRI(n)=nn 

Selection Priority) 



The &XPRI(n) parameter specifies the output selection priority for the output interval 
specified by the corresponding &XLIN(n) parameter. 

If you do not supply a /*PRIORITY control card with your job, the job scheduling 
priority is recomputed after execution, based on the actual number of print and punch 
records it produced. If the job produced p print lines and c punched cards, its output 
priority will become &XPRI(n), where n is the smallest number for which: 

p + c<&XLIN(n) 

If this parameter is not specified, the following are used as default values: 

&XPRI(1)=9 
&XPRI(2)=8 
&XPRI(3)=7 
&XPRI(4)=6 
&XPRI(5)=5 
&XPRI(6)=4 
&XPRI(7)=3 
&XPRI(8)=2 
&XPRI(9)=1 

Refer to the &RPRT(n) and &XLIN(n) parameters for additional information. 

Lower Limit: 

Upper Limit: 15 

Default: Refer to the list of default values given above. 
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CHAPTER 4. JES2 PROCESSING 



By means of JES2 and RMT generation and JES2 initialization, you can define and 
control the configuration of job entry sources and job output destinations. You can also 
indicate how JES2 is to control certain aspects of job input, queuing, and output. 

This chapter describes the aspects of JES2 processing that you can affect by means of 
generation and initialization parameters and operator commands. For specific informa- 
tion about coding generation and initialization parameters, refer to Chapters 2 and 3. For 
information about the operator commands, see Operator's Library: OS/VS2 JES2 
Commands. 



Configuration 



Local Device 
Configuration 



During JES2 initialization, the system programmer can specify the configuration of JES2 
local devices, the JES2 internal reader facility, the JES2 remote lines and devices, and the 
JES2 spool volumes. 

Local devices are card readers, printers, and card punches attached to the MVS system 
that are used for reading jobs and writing output. 

During JES2 initialization, the system programmer specifies the number of readers, 
printers and punches to be controlled by JES2 with the &NUMRDRS, &NUMPRTS and 
&NUMPUNS parameters. 

The system programmer can identify the devices that are to be used by JES2 with the 
READERnn, PRINTERnn and PUNCHnn parameters. The system programmer can also 
specify JES2 processing parameters to be associated with each device and indicate 
whether the device is to be considered active or inactive upon completion of JES2 
initialization. An active device is dynamically allocated during JES2 initialization, and 
processing on that device begins as soon as work is available. An inactive device must be 
activated by the operator with the JES2 START command ($S). 

If, during JES2 initialization, the system programmer does not identify as many devices 
(with the READERnn, PRINTERnn, and PUNCHnn parameters) as were specified (with 
the &NUMRDRS, & NUMPRTS, and &NUMPUNS parameters). JES2 selects devices and 
dynamically allocates them. Devices are selected according to lowest device address for 
each type of device (reader, printer, punch), until the number specified (in &NUMRDRS, 
&NUMPRTS, and &NUMPUNS, respectively) is obtained or no devices of that type 
remain. For a device to be selected, it must be physically attached to the system. For 
devices not identified to JES2 during JES2 initialization, default parameters or 
parameters established during JES2 initialization are used. 

During JES2 processing, devices can be activated with the JES2 START command ($S) 
and deactivated with the JES2 STOP command ($P). 



Internal Reader 



The internal reader facility is defined with the INTRDR parameter. During JES2 
initialization, the maximum number of job streams that can be simultaneously entered 
through the internal reader facility is specified (&NUMINRS). To JES2 it appears that 
this number of devices is attached. Actually, there is one internal reader facility. Refer to 
"The Internal Reader Facility" in the section describing job submission. 
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Remote Line and 
Device Configuration 



The maximum specified by the &NUMINRS parameter does not apply to the system 
internal readers associated with the time-sharing LOGONs (TSUINRDR) and started tasks 
(STCINRDR). 

JES2 supports both SNA (systems network architecture) and BSC (binary synchronous 
communication) RJE terminals. Configuring these devices consists of defining remote 
station facilities, teleprocessing lines, and, for SNA terminals (for example, a 3770 or a 
System/32 work station), logical lines. The remote facility can range from one remote 
terminal (for example, a 2770 or 3780) to a remote work station consisting of a 
computer operating many devices. 

During JES2 initialization, the system programmer: 

• Specifies the maximum number of teleprocessing lines (including logical lines for SNA 
terminals) supported by JES2 (with the &NUMLNES parameter). 

• Specifies the maximum number of remote stations supported by JES2 (with the 
&NUMRJE parameter). 

• Identifies and specifies characteristics for each line, remote station, and remote device 
(with the LINEnnn, RMTnnn, Rnnn.RDm, Rnnn.PRm, and Rnnn.PUm parameters). 

Physical and logical (SNA) teleprocessing lines are either dedicated (permanently 
attached) to a remote station or nondedicated. A line is dedicated if the line number is 
specified in the RMTnnn parameter that describes the remote station. Any line not 
designated by any RMTnnn parameter is a nondedicated line, and may be used by any 
station. JES2, however, does not support multiple remote stations active on the same 
line. 

The remote station operator can control the remote station and the remote station 
devices, jobs submitted through the remote station, or data routed to it. This control can 
be effected through the remote console or the remote card reader. Each remote station is 
considered an extension of the local JES2 facility. For more detailed information about 
remote devices controlled by JES2, refer to Chapter 5. 



Spool Configuration 



JES2 uses the SYS1. HASP ACE data set on each volume identified as a spool volume to 
store all job input, job output, JES2 control blocks, and system data such as the job 
journal. Spool volumes are identified to JES2 by volume serial number. A six-character 
name identifying the primary spool volume is specified in the &SPOOL parameter during 
JES2 initialization. 



Each volume with a volume serial number matching the first five characters of the 
&SPOOL parameter is considered a spool volume by JES2 and is searched for a 
SYS 1. HASP ACE data set. The maximum number -of volumes that can be used as spool 
volumes is specified during JES2 initialization with the &NUMDA parameter. 

The system programmer specifies the manner in which the tracks of the volumes are 
allocated and subdivided into physical records by specifying the &NUMTGV and 
&BUFSIZE parameters. 

The tracks are also subdivided into track cells, which are sets of JES2 buffers (physical 
records) grouped together on a spool volume in a logical order. The system programmer 
indicates the number of records in each track cell by specifying the &TCELSIZ parameter 
during initialization. If the track-cell method is used for despooling data, each track cell 
that is to be sent to a printer, rather than each record, can be taken from the spool 
volume in one operation; thus, it is not necessary to have a separate operation for each 
record. 
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For further discussion of the JES2 spool volumes, refer to Chapter 7. 

JES2 also requires one SYS1 .HASPCKPT data set on a direct-access volume to store a 
copy of the JES2 queue and other information needed for warm start. This data set may 
be on the primary spool volume or on another volume as specified by the &CHKPT 
parameter during JES2 initialization. See Chapter 2 for a description of how to allocate 
this data set and the SYS1. HASP ACE data sets. 



Starting and Stopping JES2 



JES2 and the parameters that define its operation are selected during job entry subsystem 
initialization. Initialization of MVS and of the job entry subsystem JES2 are two distinct 
processes. Basically this means that those processes associated with initialization (cold 
start, warm start) are specified separately for MVS (reloading the LPA, clearing the VIO 
data sets) and for JES2 (initializing the job queues). Although for any given IPL it is 
possible to cold-start one (MVS or JES2) and warm-start the other, the usual procedure is 
a warm start for both. A detailed description of the process and options for an IPL 
generally, and for starting and stopping JES2 particularly, is located in Chapter 3. 



Controlling Job Submission and Queuing 



Jobs are submitted through the job entry subsystem and queued in priority order. The 
system programmer can use various parameters and facilities to control input streams, to 
control the specificiation of job classes and generation of priorities for jobs, to hold or 
release jobs, to set the default performance group for a job, and to change these 
specifications by changing entries in the JES2 job control table using the JES2 JOB 
statement accounting field scan exit. 



Submitting Jobs 



Jobs are submitted to JES2 in three ways: 

• Through card readers allocated to JES2 

• Through RJE devices allocated to JES2 

• Through a JES2 internal reader facility 



Local Device Submission 



Local card readers can be supported via the JES2 automatic starting facility by specifying 
AUTO on the READERnn JES2 initialization parameter. Job streams can then be entered 
simply by readying the card reader. No other operator action is necessary. The card 
reader is deactivated and deallocated from JES2 with the JES2 stop ($P) command. 



Remote Job Submission 



The RJE support is described separately in Chapter 5. JES2 processes remote jobs no 
differently than it processes those received from local card readers or the internal reader 
facility. 



The Internal Reader 
Facility 



An internal reader job stream is identified to JES2 by the fact that an output data set 
specifying a special user writer (INTRDR) has been allocated dynamically or by means of 
SYSOUT=(x,INTRDR) coded on a DD card. JES2 recognizes such data sets and places 
them in the input stream, thus allowing jobs and system tasks to enter jobs in the input 
stream. 



A job entered through an internal reader begins with a //JOB statement and ends with the 
next //JOB statement, a /*EOF statement, or the closing of the internal reader data set. 
Abnormal closing or closing after a WRITE error causes deletion of the last job. A /*DEL 
statement may be used to explicitly delete the last job. 
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The class to which the internal reader data set is allocated (for example, class X if 
SYSOUT=(X,INTRDR) is specified) becomes the message class for the submitted job 
unless the JOB statement contains a MSGCLASS parameter. If the internal reader data set 
is dynamically allocated without a class specified, the message class of the submitting job 
or TSO user is used. Two exceptions to this are time-sharing logons and started tasks. 
These are assigned the TSUMCLASS and STCMCLASS JES2 initialization parameter 
values. The DEST parameter, if specified for the internal reader allocation, becomes the 
default print data destination for all jobs submitted through that internal reader. 

JES2 provides the capability of receiving multiple jobs simultaneously through the 
internal reader facility. The system uses it to pass started tasks, TSO logon, and TSO 
background jobs to JES2. Also, job streams can be read from tape and disk (any 
QSAM-supported device) and submitted through the internal reader using the RDR 
procedure, and any job executed in MVS can use the internal reader facility to pass a job 
stream to JES2. 

Controlling the Internal Reader Facility: Although the internal reader facility appears to 
JES2 as multiple input devices (maximum specified in the &NUMINRS parameter during 
JES2 initialization), the facility is controlled as one entity. The number (&NUMINRS) of 
internal readers is the number of jobs that can be received simultaneously through this 
facility. 

Characteristics of the facility are specified during JES2 initialization as subparameters of 
the INTRDR parameter. 

Using the RDR Procedure: The procedure supplied by IBM for using the' internal reader 
facility to read jobs from tape or disk is named RDR. The starter system provides the 
RDR procedure in SYS1.PROCLIB to allow the operator to start JES2 generation (see 
Figure 4-1). Basically the same procedure can be used to read a jobstream from any 
QSAM-supported device. The operator uses the RDR procedure as follows: 

• To read a job stream from the second file of a tape named JOBTAP on device 180: 
RDR,1 80,JOBTAP,LABEL=2,DSN=JOBS 

• To read a job stream from a cataloged library of jobs: 
RDR,3330,DSN=PRODUCTN(PAYROLL) 

• To read a job stream starting with a specific job on a tape named JOBTAP, the 
operator must submit a job to JES2: 

//READJOBx JOB 

EXEC RDR 

DD DSN=JOBS,VOL=SER=JOBTAP, 

UNIT=3400,DISP=OLD 



// 
//IEFRDER 

II 
//SYSIN 



DD 
EDIT 



START=JOBx 



I* 



//IEFPROC EXEC PGM = IEBEDIT 



//SYSUT1 DD 

//IEFRDER DD 

//SYSUT2 DD 

//SYSPRINT DD 

//SYSIN DD 



DDNAME = IEFRDER 

DSN = NULLFILE.DISP = OLD 

SYSOUT = (A,INTRDR) 

SYSOUT = A 

DUMMY 



Figure 4-1. The RDR Procedure 
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The system programmer can define internal readers on EXEC statements in such a 
manner that they are started conditionally. This allows the formation of a set of 
dependent jobs that can be executed without operator intervention. For example: 

• To submit JOBB and JOBC if the first four steps of JOBA are completed successfully. 



//JOBA 

//STEP1 



JOB 
EXEC 



//STEP5 EXEC RDR,COND=(8,LE) 

//IEFRDER DD DSN=JOBS(JOBB),DISP=SHR 

// DD DSN=JOBS(JOBC),DISP=SHR 

To submit JOBB if JOBA terminates normally, JOBC if it terminates abnormally, and 
JOBD in either case. 



//JOBA 

//STEP1 



JOB 
EXEC 



//STEPN EXEC 

//IEFRDER DD 

//STEPN1 EXEC 

//IEFRDER DD 

//STEPN2 EXEC 

//IEFRDER DD 



RDR 

DSN=JOBS(JOBB),DISP=SHR 

RDR,COND=ONLY 

DSN=JOBS(JOBC),DISP=SHR 

RDR,COND=EVEN 

DSN=JOBS(JOBD),DISP=SHR 



User-written procedures and programs can further exploit the internal reader facility to 
select particular jobs, to generate special job streams, and to allow operator submission of 
production job streams. 



Controlling Job 
Queuing 



In JES2, jobs are queued by priority sequence and, when ready for execution, within 
individual classes. The system programmer can control job selection through determining 
job class and priority. 



The JES2 Queue 



A job received by JES2 is queued in job priority order on the JES2 queue residing in the 
JES2 address space in main storage. A job is considered received by JES2 when it has 
been totally read in and the JES2 control blocks placed on the spool. 



The queue entry for each job contains the job name, job priority, a flag to indicate the 
job is held, pointers to JES2 control blocks on the spool, and the JES2 process (JCL 
conversion, execution, output processing, purging) for which the job is next eligible. Jobs 
are selected in priority order for each JES2 process. Logically, the one JES2 job queue 
has queues for each process, plus 38 (one for each class) within the execution process. 

A job which is held is not removed from the queue ; instead it is made ineligible to be 
selected for any JES2 processing. A job can be held at any time. Thus a job in execution 
that is held by the operator, is not eligible for output processing until released. The 
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holding of a job that is read for execution can occur by job, by class, or by holding all 
jobs. 

Job Class There are 38 classes of jobs possible under JES2. Two are used by the system: STC for 

started task control, and TSU for time-sharing logon. The other 36 classes, A-Z and 0-9, 
are for normal jobs and can be used to help control the job mix. 

The job class is specified on the JOB statement (CLASS=jobclass). If not specified, a class 
based on the particular device through which the job is entered into JES2 is assigned. All 
jobs entered through the internal reader facility are considered to be entered through a 
device described by the INTRDR parameter. 

There are no absolute rules for assigning job classes, and some experimentation is 
necessary. Generally, jobs of similar characteristics and identical processing requirements 
should be assigned to the same class. For example, if several jobs are time-dependent and 
are executed in nonpageable dynamic storage, it may not be desirable to tie up all of 
nonpageable dynamic storage by having these jobs running concurrently. These jobs may 
all be assigned to class B (or C or D— class names have no inherent meaning); then, if only 
one initiator is started that can handle class B jobs, there will never be more than one of 
these jobs in execution at once. 

Suppose the following assignments are made: 

Class B = jobs that are time dependent 
Class C = jobs with high CPU requirements 
Class D = jobs with high I/O requirements 

The system programmer can specify initiator parameters such as: 

11 CLASS=BCD 

12 CLASS=CDB 

13 CLASS=DCB 

If the three initiators are processing jobs with the same priority and all necessary 
resources (for example, I/O devices and data sets) are available, then three jobs, one from 
each of the three different classes, run concurrently. If a job within one of the classes has 
higher priority than the others in the class, it will be initiated first. 

During JES2 initialization, the system programmer can assign job characteristics to jobs 
queued in each class. Characteristics that can be assigned are: 

• A default performance group for each job. 

• JCL conversion parameters. 

• Whether a JES2 job log is to be produced for jobs in this class. The JES2 job log is a 
list of all messages and replies issued by, or on behalf of, a job. 

• Whether a system journal is to be saved for jobs in this class. If it is not saved, the 
overhead is avoided but the job may not be automatically restarted in case of job 
failure or system restart. 

• Whether this class is reserved for the execution batch scheduling facility. (See 
"Execution Batch Scheduling".) 

• Whether output is suppressed for jobs in this class (for example, started tasks). 

• The procedure library (PROCnn) definition. 

• SMF options. 

• Whether the jobs in this class are to be held. 
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• Whether the jobs in this class are to be copied to message class output or converted but 
not executed. 

• Whether the job is restartable, in the event of a JES2 warm start. 

The system programmer should assign separate job classes to jobs that are to be assigned 
separate characteristics, and to jobs that have different execution characteristics such as: 

• Rate of CPU to I/O processing 

• Use of special devices 

• Number of devices used 

• Use of real storage 

Job priority is determined through use of the /*PRIORITY statement, the PRTY 
keyword on the JOB statement, or by an algorithm that uses programmer-supplied or 
initialization job characteristic data. 

In addition an increment can be added to the priority and a priority limit enforced, 
depending on the device through which the job entered JES2. Those parameters are 
associated with the input device during JES2 initialization. 

Specifying Priority: Priority may be specified on the /*PRIORITY statement. If 
specified, it must immediately precede the JOB statement, or the input stream is flushed 
until another JOB or PRIORITY statement is found. Priority may also be specified 
through use of the PRTY keyword in the JOB statement. 

Calculating Priority: When the scheduling priority is not specified on the /*PRIORITY 
statement or the JOB statement, priority is calculated using estimated execution time and 
the estimated number of output lines and cards. These values can be supplied through the 
JOBPARM statement, the accounting information on the JOB card, or the JES2 
initialization parameters (&ESTIME, &ESTLNCT, &ESTPUN). 

To calculate priority, these estimates are used in conjunction with four JES2 initialization 
parameters, each of which is supplied (or assumed by default) as a table of values. These 
are the &XLIN(m), &RPRT(n), &RPRI(n), &XPRI(m) parameters. The default values 
for these tables are used for the examples of priority calculation that follow. The default 
values are : 



For &XLIN: 

(&XLIN values are estimates 
of the number of output lines 
and cards for a job.) 



&XLIN(m) 


m 


2000 


1 


5000 


2 


15000 


3 


2 24 -l 


4 



>24 



For &RPRT: 

(&RPRT values are estimates 
of the number of minutes a job 
will take to run.) 



&RPRT(n) 


n 


2 


1 


5 


2 


15 


3 


(2 24 -l)/60 


4 



(2 24 -l)/60 
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&XPRI(m) 


morn 


or &RPRI(n) 


1 


9 


2 


8 


3 


7 



For both &XPRI and &RPRI: 

(The m and n values are determined from 

the &XLIN and &RPRT tables. Note that 

the &XPRI and &RPRI tables can have two 

different sets of values. The values described : : 

here are the default values.) 9 1 

Priority is calculated by using the values specified for &XLIN and &RPRT to determine 
m and n from the table. These m and n values are then used with the &XPRI and 
&XRPRI tables to determine values for &XPRI(m) and &RPRI(n). Priority is then 
calculated as: 

PRIORITY = [&XPRI(m) + &RPRI(n)] -f 2 
The following examples illustrate the use of the various parameters in this calculation. 

Example 1. The programmer estimates 2000 lines plus cards, 2 minutes execution time. 

From &XLIN, 2000 lines implies m=l 
From &RPRT, 2 minutes implies n=l 
From &XPRI, m=l implies &XPRI=9 
From &RPRI, n=l implies &RPRI=9 

Therefore PRIORITY = (9 + 9) -^ 2 = 9 

Example 2. The programmer estimates 4000 lines plus cards, 15 minutes execution time. 

From &XLIN, 4000 lines implies m=2 
From &RPRT, 15 minutes implies n=3 
From &XPRI, m=2 implies &XPRI=8 
From &RPRI, n=3 implies &RPRI=7 

Therefore PRIORITY = (8 + 7) -s- 2 = 7. (The fraction is ignored; only the integer value is 
used.) 

Example 3. The programmer estimates 15,000 lines plus cards, 10 minutes execution 
time. 

From &XLIN, 15,000 lines implies m=3 
From &RPRT, 10 minutes implies n=3 
From &XPRI, m=3 implies &XPRI=7 
From &RPRI, n=3 implies &RPRI=7 

Therefore PRIORITY = (7 + 7) h- 2 = 7 

If priority is computed for the job during input, it is recomputed for output. Output 
priority is based on the count of lines and cards (&XLIN) actually produced during job 
execution. The execution time parameter &RPRT is ignored. 

The system programmer, by specifying other values for the tables during JES2 
initialization, can more closely control priority specification. Values specified on the 
JOBPARM statement supercede those in the account field of the JOB statement. During 
JES2 initialization, the &RJOBOPT parameter can be specified to ignore the account 
field on the JOB card. 
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Priority Aging 



Scanning the JOB 
Statement Accounting 
Field 



The priority of a job can be increased as a function of the length of time that it has been 
in the system. The &PRIHIGH, &PRILOW, and &PRIRATE JES2 initialization 
parameters specify respectively a limit above which there is no incrementing, a limit 
below which there is no incrementing, and an integer representing the number of times 
that the priority is incremented in a 24-hour period and subject to the upper limit. The 
default of for the &PRIRATE parameter specifies no priority aging. 

The &PRIRATE parameter specifies whether the feature is used and, if so, how many 
times in a 24-hour period the priority is incremented. For example, &PRIRATE=48 
specifies a priority increment of one unit every 30 minutes. The &PRIHIGH parameter 
specifies the upper limit; a priority lower than the value of the &PRILOW parameter 
specifies that the job is not subject to priority aging. 

During JES2 initialization the &RJOBOPT parameter is specified to determine whether 
JES2 is to scan the accounting field of the JOB statement, and to set the conditions 
under which JCL errors detected by scanning cause job termination prior to JCL 
conversion. Figure 4-2 describes the &RJOBOPT options. 

The account field is considered valid if its format is that specified for JES2. For a 
description of the JES2 format for the accounting field, see the accounting field 
parameter in OS/VS2 JCL. 

The JCL scan is not exhaustive; only JOB, DD *, and DD DATA statements are scanned. 
Job termination on a JCL error at this point does not guarantee that all JCL errors have 
been found. If the job is not terminated on a JCL error at this point in the process, it can 
still fail during JCL conversion when all JCL is scanned. 

Job Statement Accounting Field Scan Exit: A routine can be written that allows the 
installation to control a job by modifying data in the JES2 job control table (JCT) 
immediately following the scan of the user's JOB statement. Figure 4-3 shows selected 
fields from the JCT. 

The name of the CSECT must be HASPRSCN and must replace the existing CSECT of 
that name in the HASJES20 load module. This routine receives control from JES2 with 
registers set as follows: 

R0 A binary number giving the length (in bytes) of the accounting field 

Rl Address of the accounting field from the JOB card 

R2 Address of the SMF job management record (as defined in the description of 

the MVS Common Exit Parameter Area, OS/VS System Management Facilities 

R8 Base Register 

Rl Address of the (JES2) JCT 

R13 Save area (18 words) 

R14 Return address 







Terminate if 


Terminate 




Scan Account 


Account Field 


if JCL 


&R JOB OPT 


Field 


Invalid 


Invalid 





Yes 


Yes 1 


Yes 


1 


Yes 


Yes 1 


No 


2 


Yes 


No 


Yes 


3 


Yes 


No 


No 


4 


No 


- 


Yes 


5 


No 


- 


No 


1 If these values i 


are indicated, the first two subfields of the account field (pano and room) 


are required. 









Figure 4-2. Job Statement Accounting Field Scan Exit 
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Field name Length 

in JCT (bytes) Notes 



Field 



JCTSMFLG 


1 




SMF Flags: 








- 


bit 0-1 


Reserved 






1,2 


2 


If set, IEFUSO exit not taken 






- 


3-4 


Reserved 






1,2 


5 


If set, no Type 6 SMF records produced 






1,2 


6 


If set, I EFUJP exit not taken 






1,2 


7 


If set, no Type 26 SMF record produced 


JCT JOB FL 


1 




Job Flags: 








- 


bitO 


Background job 






- 


1 


TSO (foreground) job 






- 


2 


Started task 






1,2 


3 


No job journaling 






1,2 


4 


No output 






1,2,3 


5 


TYPRUN=SCAN 






2,3 


6 


TYPRUN=COPY 






1,2,8 


7 


Job restartable 


JCTJBOPT 


1 




Job Options: 








- 


bitO 


/*PRIORITY card was read, value in Priority 
field (JCTIPRIO) 






- 


1 


/*SETUP card was read 






1,2,4 


2 


TYPRUN=HOLD was specified 






1,2,6,8 


3 


No job log for this job 






1,2 


4 


Execution batch job 






- 


5 


This job was read through an internal reader 






- 


6 


The job was rerun 






- 


7 


Reserved 


JCT JO BID 


8 


- 


JES2 JOB identifier 


JCTJNAME 


8 


3 


Job name 




JCTPNAME 


20 


3 


Programmer 


name 


JCTMCLAS 


1 


1,4 


Message class 


JCT JC LAS 


1 


1,4 


Job class 




JCTIPRIO 


1 


1,5 


Priority 




JCTROUTE 


2 


- 


Route code of input device 


JCTINDEV 


8 


- 


Input device 


name 


JCTACCTN 


4 


1,6 


Account number (for HASP compatability) 


JCTROOMN 4 


1,6,8 


Room number 


JCTETIME 


4 


1.6,8 


Estimated real time job will run 


JCT EST LN 


4 


1,6,8 


Estimated count of output lines (in thousands) 


JCTESTPU 


4 


1,6,8 


Estimated number of output cards punched 


JCTFORMS 


4 


1,6,8 


Job Forms 




JCTCPYCT 


1 


1,6,8 


Job copy count (binary) 


JCTLINCT 


1 


1,6,8 


Lines per page (binary) 


JCTPROUT 


2 


1,7 


Default print routing (binary) 


JCTPUOUT 


2 


1,7 


Default punch routing (binary) 











Any local device 








1-999 


Remote devices 








1001-1999 


Specific local devices 


JCTPROCN 


8 


1,2,8 


Procedure DD name 



Notes: 



1. Can be modified by installation routine. 

2. Preset from $x initialization parameter according to job class. 

3. Preset from JOB statement. 

4. From JOB statement, if specified; otherwise according to input device as established at 
JES2 initialization (for example, in READERnn). 

5. Preset from /'PRIORITY statement or an "*". 

6. The HASPRSCN routine is used by JES2 to scan the account field of the JOB statement. 
If the HASPRSCN routine is replaced by an installation-written routine, the accounting 
field is empty. 

7. Preset according to an input device initialization parameter (for example, READERnn). 
If not set at initialization, the job input source value (LOCAL or RMTnnn) is used. 
Can be modified by a ROUTE statement after the scan exit. 

8. Can be modified by a JOBPARM statement after the scan exit. 



Figure 4-3. Selected JES2 Job Control Table Fields 
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Registers 3-14 must be restored when control is returned to JES2. The save area 
addressed by R13 can be used to store registers. There are no return codes necessary. 

Programming Notes: Parameters of the JOBPARM statement or ROUTE statement can 
override changes made with this routine. Otherwise the change is effective for the 
duration of the job. 

Data placed in the user identification field of the SMF record at this time is available to 
the programmer at all SMF exits. 

If system services that have implied waits (for example, a WTO command for fhe SMF 
WTM) are used by this routine, severe system degradation may occur. 

Because this routine runs under the JES2 task, if abnormal termination occurs, JES2 
must be restarted. 



Controlling Conversion and Execution 



The converter converts the JCL for a job, logon, or started task into internal text. The job 
is then available for execution, which occurs as soon as an initiator eligible to process the 
job is available. 



JCL Conversion 



Unless it is held, a job is eligible for JCL conversion as soon as it is placed on the queue. 
The converter, invoked separately for each job, receives the converter parameters and a 
pointer to a procedure library from JES2. 



Converter Parameters 



If default values are not established by the initialization parameters &RDROPSU, 
&RDROPST, and &RDROPSL, the converter parameters are specified for each class on 
the CONVPARM subparameter of the &STC, &TSU, or &X parameters during JES2 
initialization. Converter parameters specify default values such as execution time estimate 
and JCL and allocation MSGLEVEL options. Command disposition and authority and 
the bypass label options are specified. The specific parameters are described in Chapter 3. 



Procedure Library 
Selection 



The JES2 Procedure is located in SYS1.PROCLIB. It defines job-related procedure 
libraries such as: 

//PROC00 DD 
//PROC01 DD 



//PROCnn DD 
//anyname DD 

The programmer can specify any of the libraries included in the JES2 procedure on the 
JOBPARM statement by specifying the library data definition name. If multiple data sets 
are required they must be specified as concatenations in the JES2 Cataloged Procedure. 

If there is no procedure specification on the JOBPARM statement, class-related 
initialization parameters can specify the library as PROCnn. If the procedure is not 
specified, or specified, but not found, PROC00 is used. 
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Execution Control 



The Initiator 
Cataloged Procedure 



Execution is controlled by controlling the initiators and the jobs on the queue (See 
"Controlling Job Queuing"), as well as by monitoring the job and issuing commands. 

JES2 associates one logical initiator residing in JES2 with each system initiator 
interfacing with JES2. The maximum number of logical initiators is specified during JES2 
initialization (&MAXPART parameter). The number of active logical initiators, subject to 
the maximum, is controlled by the operator ($S Innnn). The operator can also associate 
with logical initiators the order in which the classes are selected by JES2. 

Classes are associated with each initiator during JES2 initialization or dynamically by the 
operator. During execution, the initiator selects non-held jobs in priority order within 
their class, and the non-held class in the order specified for that initiator. That is, the 
lowest priority job in the first non-empty class is selected ahead of the highest priority 
job of the next class— assuming neither job nor class is held. 

One initiator cataloged procedure (INIT) must be contained in SYS1.PROCLIB for use 
by JES2 in creating job address spaces into which a system initiator is initialized. JES2 
uses the START command (system command) to create one system initiator for each 
active JES2 logical initiator. The number of active initiators must be controlled by 
starting and stopping JES2 logical initiators. 

The standard initiator cataloged procedure supplied by IBM is named INIT. The 
procedure is: 

&//IEFPROC&EXEC&PGM=IEFIIC ,DPRTY= 1 2 



Job Monitoring 



A job can be monitored by elapsed (wall clock) time, execution time, and by output in 
terms of lines and cards. 



During JES2 initialization, the &TIMEOPT parameter can be specified to cause JES2 to 
write a message to the operator when the elasped time specified on the JOBPARM 
statement is exceeded, and an additional message at each interval specified by the 
&TIMEXS parameter. The system programmer can use the SMF accounting exit to 
enforce these values, if the time was placed in the SMF user ID field during the JCL scan 
exit. The SMF exits are described in OS/VS2 System Programming Library: System 
Management Facilities (SMF). 

Execution time can be specified on either the EXEC statement or the JOB statement, or 
in the converter (CONVPARM) parameters. If the time is exceeded, the SMF exit is 
entered and the job can be canceled or continued. 

The &OUTXS JES2 initialization parameter is used to specify the total number of 
printed lines and punched cards that a job can produce before action is taken by JES2. 
The &OUTPOPT parameter specifies the action that is taken. The job can be allowed to 
continue after a message is written to the operator, or the job can be canceled with or 
without a dump. 

The installation can specify SMF output limiting by class, with the &x, &STC, and &TSU 
JES2 initialization parameters. Output (OUTLIM DD) can be monitored for each data set 
by SMF. 
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Entering Commands in 
the Job Stream 



JES2 commands and standard system commands are accepted at different points in a job 
stream, with different types of control. A job stream is defined as the set of jobs 
submitted between the physical start of a reader and physical end-of-file, or between the 
opening and closing of an internal reader data set. Refer to Figure 4-4 for a pictorial 
representation of the following paragraphs. 

JES2 commands are accepted in the job stream only if they are in front of the first //JOB 
statement of a job stream. The commands that are accepted from any given device are 
controlled by a command authority associated with the device ($T command). The 
command authority allows various combinations of display and system, job, or device 
control commands to be entered. JES2 commands are in the form /*$command. 

System commands in the form /*$VS, 'systemcommand' are accepted in front of the JOB 
statement, subject to the same authority described for JES2 commands. 

JES2 commands found in the job stream between the first JOB statement and EOF are 
ignored. 

System commands (//system cmd) that appear in the job stream after the first JOB 
statement are executed in the converter. Whether they are issued is controlled by the 
converter using the converter parameters. System commands appearing before the first 
JOB statement are ignored. 



Execution Batch Scheduling 



Execution batch scheduling is an extension of normal job scheduling that may improve 
system performance. It is the process of gathering psuedo-jobs, called execution batch 
jobs, into a single input stream for processing by an execution batch processing program. 
The execution batch jobs are submitted to JES2 one at a time; they may have different 
input sources and different print and punch output routing. Execution batch scheduling 
collects these numerous related batch jobs into a single data stream and passes them as a 
SYSIN data set to the user-written execution batch processing program. This reduces the 
overhead associated with setting up for and processing numerous individual jobs or job 
steps. Another advantage is that individual accounting for all but type 4 and 5 records is 
available. 



System commands are accepted 
(// system command) 



JES2 commands are accepted 

(/*$) 




JES2 commands are ignored 



System commands are accepted 
(/*$VS, 'system command') 



Figure 4-4. Entering Commands in the Job Stream 
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The processing programs to be used with the execution batch scheduling feature may 
cover a wide variety of application areas such as: 

• Compile-and-go debugging compilers 

• File inquiry programs 

• Hardware or software system emulators 

It is desirable that the program process jobs or transactions of relatively short duration. If 
not, the saving in job management overhead between successive jobs may not be a large 
enough percentage of total job execution time to justify use of this feature. 

At JES2 initialization, the installation defines the job class or classes that are to be 
dedicated to execution batch scheduling. One class or group of classes is assigned to each 
type of execution batch processing program. Subsequently, the batch user identifies the 
program requested by the class stated on the JOB statement. 

JES2 can support more than one execution batch processing program to process various 
kinds of batch jobs. Each execution batch processing program'must be associated with at 
least one JES2 initiator. The system initiators request a job, and JES2 decides which job 
is to be processed. 

To determine which jobs are to be processed by an execution batch processing program, 
JES2 recognizes jobs assigned to eligible classes. Instead of sending these jobs directly to 
an initiator, JES2 invokes an appropriate procedure from PROCLIB to initiate the 
execution batch processing program. The job as submitted is now considered part of the 
input data of the execution batch processing program. 

For example, consider an order entry system that requires an inventory update and an 
invoice for each order. With standard processing, the normal procedure would be to batch 
all orders and submit them as a data stream at the end of the day to an order entry 
system. 

However, this causes delay. Alternatively, the installation can periodically batch together 
orders received during a certain time period and run the job several times a day. By using 
the execution batch scheduling facility, orders can be processed as if the order processing 
program were scheduled for every order, but without the overhead of scheduling the 
order program for the runs. 

The order entry program would become an execution batch processing program. The 
orders themselves would be submitted as execution batch jobs by taking the order data 
that would have been submitted in batch, and putting a system JOB statement in front of 
it. In an order entry program accustomed to reading batch jobs at the end of the day, the 
only programming changes would be (1) to use the ddname SYSIN for the input stream 
(this may be accomplished by JCL in PROCLIB), (2) to recognize the null statement as 
an order separator or establish other defined terminators, and (3) to ignore all other JCL 
(//) cards. The program would have to print all related information for each order before 
processing the next order, to distinguish one from another. JES2 automatically schedules 
the order entry program when it is needed and concatenates all orders into the input 
stream data regardless of where they originate. 



Submitting Input to an A representative input stream follows: 
Execution Batch u jq B 

JES2 control statements 
input 



Processing Program 
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Execution Batch 
Scheduling Operations 



To submit data to an execution batch processing program, follow these rules: 

• The first statement of each job must be a standard JOB statement that includes a 
CLASS=job class parameter. The job class identifies which program is to receive the 
input. The installation associates job classes with an execution batch facility by means 
of the procedure library. It associates job classes with initiators at initialization. The 
accounting field is interpreted by JES2 as it is for normal jobs. 

• All JES2 control statements are effective with batching jobs except /*OUTPUT, which 
is ignored. 

• No other JCL is used. All other statements are input to the execution batch processing 
program. These can be read as if they had been placed in a DD DATA data set and the 
execution batch program had been invoked by standard JCL. If the execution batch 
program requires it, each transaction can be terminated by a statement with $$ in 
columns 1 and 2. 

In the order entry system example mentioned earlier, code the following: 

//JOBxx JOB (INV01,667),CLASS=X 

/*ROUTE PRINT RMT47 

order 1 
order 2 

The /*ROUTE statement causes the invoice to be printed at the remote location. 

Special actions take place when JES2 recognizes input for an execution batch program. If 
the execution batch program is not already active, JES2 submits an internal job which 
uses JCL from SYS1.PROCLIB to invoke the execution batch processing program when 
an initiator capable of processing it becomes available. JES2 control cards are converted 
to JCL comment statements. The entire input, plus a JCL null statement added by JES2, 
is allocated to the execution batch processing program as an input data set with the 
ddnameofSYSIN. 

If the execution batch program is already active and simply waiting for another job, JES2 
makes the input data set allocation as above, and processing begins immediately without 
any use of job management. 

The end of input can be detected by the execution batch program when it reads the JCL 
null statement added by JES2. After writing any remaining SYSOUT data for the 
completed job, the execution batch program attempts to read ahead in its input file for 
another transaction. JES2 detects this condition, temporarily forces the execution batch 
program into a wait state, and performs job termination actions for the execution batch 
job (flushes output buffers, releases input spool space, queues the job for printing, and so 
forth). The execution batch program remains active in the MVS address space. 

When an execution batch program is waiting, JES2 job selection is altered. Instead of 
scanning for all classes eligible for execution in that address space, JES2 first tries to start 
an execution batch job which may be processed by that execution batch program. If 
successful, processing can begin immediately. 

If no jobs of the same execution batch class are available for execution, all other job 
classes of the address space are scanned in order. If a job is found, JES2 internally cancels 
the execution batch processing program and normal scheduling, using job management, 
takes place. 

If no jobs of the other classes are found, the address space and execution batch processing 
program remain idle, awaiting availability of a job in any of its classes. If a job becomes 
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available in the class of the execution batch program still in the address space, processing 
begins immediately. 

If an execution batch program ends (ABEND or normal return to MVS), JES2 detects 
this as a nonbatch termination in the address space. Job management is used to reinvoke 
the execution batch program when another job for its class is selected. 

The operator command $P I or $P In causes JES2 to cancel an execution batch processing 
program when it becomes idle and delete the address space. 

In summary, an execution batch processing program must have certain characteristics: 

• It must read all user input from a single sequential data set. 

• It must recognize a standard OS JOB statement, or its own control statement, to 
determine the beginning of a job. 

• It must recognize a standard OS NULL JCL statement (// followed by 70 blanks), or 
its own control statement, to determine the end of a job. 

• To ensure system integrity, it should not use dynamic allocation of SYSOUT data sets. 

The execution batch processing program receives an end-of-file condition when a card 
with $$ in columns 1 and 2 is read while processing a job. The program may continue to 
the next logical subfile by simply resetting appropriate bits in I/O control blocks and 
continuing reading, or by closing and reopening the data set to continue reading starting 
with the card following the $$ card. 



Preparing for Execu- 
tion Batch Scheduling 



The batching feature is activated in JES2 by setting the &XBATCH=YES parameter 
during JES2 initialization. Job classes are reserved for execution batch jobs with the $$x 
initialization parameter. The &XBATCHN JES2 initialization parameter may be set to 
define the first five characters of the procedure name that contains the JCL necessary to 
execute an execution batch program. (See Chapter 3 for a description of this parameter.) 

Each batch class should be associated with one execution batch program. Each batch class 
should be made eligible for execution in the MVS address space by setting the Innnn 
initialization parameter or by using the $T In operator command. 

For each combination of batch class and initiator, there must be a procedure in 
SYS1.PROCLIB named nnnnncid, where: 

• nnnnn are the five characters assigned to &XBATCHN. 

• c is the particular batch job class set in $$x. 

• id is the 1- or 2-character initiator identification, corresponding to nnnn of the Innnn 
parameter. 

These procedures call the execution batch program for each class and define all data sets 
other than the user input data set. 

The procedures may be single step, or may have preliminary steps before the single step 
that invokes the execution batch program (step name GO). The execution batch program 
invoked by this step must read its input from a SYSIN, or the procedure must refer to 
DDNAME=SYSIN on a DD statement used for input by the processing program. 

If a given batch class is eligible (the Innnn initialization parameter or $T In operator 
command defines eligible classes) for execution by more than one initiator, the 
requirement for a separate procedure name for each address space/class combination may 
be satisfied by alias names of a single procedure or by separate procedures that specify 
different work fields. 
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The following example shows the internal job that JES2 generates to initially load a 
program to process batch class X jobs for Init=3, assuming the default setting for 
$ XBATCHN. 



//$$$$$X3 JOB 


1,SYS,MSGLEVEL=1 


//FAKE EXEC 


$$$$$X3 


//GO.SYSIN DD 

// 


DATA,DCB=BUFNO=l 



The following is an example of a procedure that might be used for a simple file inquiry 
program that reads inquiry input from SYSIN, checks a file, and prints responses to 
SYSPRINT. 

//$$$$$X3 PROC 

//GO EXEC PGM=FINDPART 

//SYSPRINT DD SYSOUT=A 

//PARTFILE DD DSN=PARTFILE.MASTER,DISP=SHR 

//SYSUDUMP DD SYSOUT=A 

The following JCL is for the order entry system example. 

//$$$S$X3 PROC 

//MDSE EXEC PGM=ORDERIN 

//MESSAGE DD SYSOUT=M 

//INVOICE DD SYSOUT=(P„INVC) 

//INVTRY DD DSN=MSTRINVT,DISP=SHR 

//ORDERS DD DSN=ORDERS,DISP=MOD 

• //MESSAGE: The installation might identify class M as a punch class. This will allow 
the submitter of the execution batch job to route the invoices and messages separately, 
as shown in the example in "Submitting Input to an Execution Batch Processing 
Program". 

• //INVOICE: Defines the specially prepared output. 

• //INVTRY: Uses a master inventory list as a base; it is updated as the orders are 
received. 

• //ORDERS: Accumulates the day's orders. ORDERS has a disposition of MOD 
because the execution batch processing program is periodically started and stopped 
during the day. 

• SYSOUT data sets: The messages and invoices. 

• SYSIN data sets: The DD DATA input is every execution batch job that is processed 
by the execution batch processing program. 



Controlling System Output 



JES2 provides: 

• Queuing levels beyond the simple output class queuing provided by the output writer. 

• The ability to specify print train and either carriage tape name or forms control 
buffers for sysout directed to 3211 and 1403 printers plus support of the 3525 print 
and interpret features for sysout data sets. 

• The ability to specify all options and features of the 3800 Printing Subsystem for 
sysout data sets directed to the 3800. 

• Features that minimize operator interaction because of forms, carriage tape, and print 
train loading for impact printers, and forms, overlay frames, and burster loading for 
the 3800, a nonimpact printer. 
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An external writer facility that, although it can be used for writing any sysout data, is 
specifically intended for writing to devices other than printers and punches and for 
controlling all output written by installation-written writers. 



Queuing Output The job output elements (JOEs) are created during output processing, or during 

execution in the case of spinoff, by JES2. Each JOE represents a unit of work to JES2, 
and is placed in a job output table (JOT) in order of output priority. If the priority was 
calculated originally, it has now been recalculated with the actual number of lines and 
cards. See "Calculating Priority." 



The JES2 print/punch processor and the external writer can select only data sets for 
which JOEs have been constructed. Varying the number of JOEs, (&NUMJOES JES2 
initialization parameter) influences the way output is processed. By specifying a large 
number of JOEs, the print/punch processors are given a large number of output data sets 
from which to choose. This minimizes the setup changes in JES2-controlled printers and 
punches by providing a series of data sets of the same class for the external writers. 
However, a given data set may wait a long time for a printer with the specified setup, for 
an available device destination, or for an available external writer to dequeue its class. 
This long wait may fill spool space, since most of a job's output-related spool space is 
freed only when all output data sets have been processed. Specifying many JOEs 
improves utilization of output devices but slows throughput for a specific job. 

Specifying few JOEs reduces the number of jobs with output eligible for printing while 
processing the entire job output more nearly together. This specification may minimize 
the turnaround of a particular job at the expense of operational efficiency. 

A job output element that does not yet describe a unit of work is said to be "free." The 
&MINJOES parameter specifies the number of JOEs that must be left to be used when the 
$1 command interrupts an output data set or when a printer is started. When the building 
of JOEs for a job would drop the number available below the specified minimum, the job 
or spinoff data is forced to wait until JOEs are available. 

JES2 queues output data by combinations of data set characteristics such as output class, 
forms, print train, forms control buffer name, forms overlay frame, and burst 
specification. (Data sets are also queued by installation writer name and by destination, as 
discussed in "External Writers" below.) These characteristics are obtained from the 
SYSOUT DD STATEMENT or the JES2 OUTPUT statement. With the exception of held 
data sets and spinoff data sets, the output of a job, started task, or time-sharing user that 
has identical characteristics is queued together in a data set group pointed to by a job 
output element (JOE). (This queueing can be altered by the demand setup option.) Each 
held and spinoff data set is queued separately and constitutes a "group" of one data set. 
Each data set group is considered a processing entity with a set of processing 
characteristics. JES2 selects work by data set groups and, if the separator option is 
specified, delimits each group with separator pages or cards. 

Figure 4-5 represents how one JOE can represent one of several SYSOUT data sets. 

JOEs built for job-related output are duplicated according to the number of job copies 
requested on the /*JOBPARM statement. This allows the number of copies being 
processed for any job to be governed by the devices available for output. 
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1 - 


SYS0UT=(A„4PLY),UCS=PN 




2 - 


SYSOUT=C,UCS=PN 


Total of seven JOEs 


3 - 


SYSOUT=A 


built 


4 - 


SYSOUT=B 




5 - 


SYSOUT=A,F LASH=F L01 




5 - 


SYSOUT=A,FLASH=FL01,MODIFY=CM03 




6 - 


S YS0UT=C,FCB=STD3,UCS=G F 1 




6 - 


SYSOUT=C,CHARS=(GF10,FM10),FCB=STD3 




7 - 


SYSOUT=C,CHARS=(GF10,FM10),FCB=STD3,UCS=PN 




3 - 


SYSOUT=A 




1 - 


SYSOUT=A 




1 - 


SYSOUT=A 


Total of three JOEs 
built 


2 - 


SYSOUT=B 




1 - 


SYSOUT=A 




2 - 


SYSOUT=B 





SYSOUT=(A„2PLY),FCB=8LPI 



1 - SYSOUT=A 



Figure 4-5. Relationship of SYSOUT Specification to Number of Job Output Elements 

Output Class Output from a problem program is assigned to an output class that is processed by JES2. 

Assignment A maximum of 36 sysout classes can be named by specifying SYSOUT=x on the DD 

statement, where x is any single letter (A-Z) or digit (0-9). The names have no inherent 
meaning; they are simply used to group output of similar characteristics. During JES2 
initialization, the fact that a class is designated as containing print or punch data is used 
for limiting output and job accounting only and has no bearing on the actual device to 
which the class is assigned. 

JES2 print/punch processors and external writers are assigned to process only designated 
classes of output. These classes can initially be assigned to JES2 devices during JES2 
initialization, to external writers in the external writer cataloged procedure, or as 
parameters of the JES2 set ($T) command or system START command, respectively. 

If output is assigned to a class for which no writer is started, it remains on the queue 
indefinitely. 

The system programmer should assign output classes in a manner that distinguishes types 
of output and results in the most efficient use of devices. JES2 automatically balances 
output scheduling which makes the assignment of classes less important than in MVT. 
However, classes should be assigned with the following characteristics: 

• Data to be processed by standard JES2 writers should be distinguished from that to be 
processed by external writers. 

• Data placed on different devices and data placed on similar devices but with 
different characteristics should be in separate classes. It is not necessary, however, to 
use classes to separate data with different punch interpretaion UCS and FCB 
requirements if the data is processed by a JES2 writer, since JES2 handles these 
parameters automatically. Class should be separate if an external writer is used to print 
this data. 
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System Message 
Classes 



• Classes should be assigned to give different priority to different types of data such as 
that to be printed on a different work shift. 

• Classes need not be specified to give priority to short data sets, since JES2 priority 
calculation can be used for that purpose. 

System messages generated during the execution of a program must also be routed to an 
output device; if messages must appear with their program output, they should be 
assigned to the same message class as the output. To guarantee that the messages and data 
appear together, all data sets for the job must be described to JES2 in a single job output 
element (JOE). 

The user may also specify during JES2 initialization (by means of the &DMNDSET 
parameter) that all job output of the same class and for the same destination as its system 
messages (MSGCLASS), JCL statement images^ and job log (if any) be placed jn a single 
JOE. This keeps the data sets together on output listings but can cause operational 
inefficiencies (see "Demand Setup" below). 

The message class is assigned as a parameter of the JOB statement. Its format is 
MSGCLASS=x, where x is any single letter (A-Z) or digit (0-9). If no message class is 
specified, the class specified for TSUMCLAS, STCMCLAS, or the device through which 
the job was read is used. 



JES2 Output 
Selection 



When assigning such things as priority, classes, and forms requirements for data sets, the 
system programmer should balance the choices against the criteria used by JES2 to select 
the output data set to be processed. 



Setup Characteristics 



As established during JES2 initialization and altered by the operator, each JES2 
controlled printer and punch posseses setup characteristics and a setup mode— manual or 
automatic. Setup characteristics for impact printers (for example, the 1403 and 3211) 
and punches are class, destination, forms, print train, and either carriage control tape or 
forms control buffer. (For a 1403 printer, JES2 uses the FCB parameter as the carriage 
control tape name. The operator is requested to mount carriage tapes by this name in a 
manner similar to mounting forms.) For the 3800 printer, setup characteristics are class, 
destination, forms, forms overlay frame, and burster specification. 

Setup characteristics determine the data set groups that are eligible for processing on this 
device. Each locally attached printer and punch posseses either a destination of LOCAL 
or a specific device-name destination. If the device posseses a specific destination name, it 
is eligible to process only data sets specifically routed to it by JCL or the operator. Each 
remotely attached printer and punch posseses a destination that is the name of the work 
station to which it is attached or the installation-assigned name of a remote pool of 
devices. Remote devices are eligible to receive only that output directed to them by JCL 
or the operator. 

Setup mode determines the manner in which data sets are selected, automatically or 
manually. 

Automatic Mode: Automatic mode is specified either at JES2 initialization (PRINTERnn 
parameter) or by the operator ($T F=AUTOM command). In automatic mode, JES2 
issues a setup message to request that the operator change the setup for the device when 
all data sets with setup characteristics matching the device have been selected. 
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When a device is available for output, JES2 selects job output elements according to the 
following: 

1 . The setup priority 

• First choice is between JOEs with setup requirements exactly matching those 
currently on the device. 

• Second choice is a JOE specifying a setup not currently being processed by any 
output device. 

• Third choice is a JOE specifying the standard forms setup as described by the 
&STDFORM initialization parameter. 

• Fourth choice is a JOE specifying a setup currently being used by another device, 
provided that that device is not set up by the operator. 

2. When the setup has been selected, the first class specified for this device by the 
operator, or during JES2 initialization, is chosen. 

3. When setup and class are selected, the highest output priority JOE with these 
characteristics is chosen. 

Some implications of the setup algorithm are: 

• If an output device has been set up explicitly by the operator ($T command), JES2 
does not set up another device to process data specifying that setup— unless the 
explicit setup is the same as that for standard forms. This is true no matter how many 
devices are idle. The operator, however, may set up another device to handle the 
output. 

• Output matching an existing device setup and class is processed before output with no 
active setup, regardless of relative priority of the jobs producing the output. 

• Output with setup requirements not loaded on any device is preferred over output 
with the setup loaded on a device that is busy. 

• Installations should ensure that class and setup conflicts do not cause data to be 
overlooked. Commands are provided to determine output backlog. 

Manual Mode: In manual setup mode (operator controlled), only data set groups with 
characteristics matching the setup of the device are selected. Manual mode printers do not 
request a new setup when there is no more work in the queue. The printer becomes idle. 



Demand Setup 



For those installations wanting data sets that have the same SYSOUT class as the job 
message class to appear together on the output listing, regardless of setup requirements, a 
demand setup option (&DMNDSET=YES) can be specified during JES2 initialization. 
The output data sets of the job, possibly with several different setup requirements, are 
then placed in the same data set group. The message data set is the first one in the group, 
and its characteristics are used for scheduling the entire group. 



The operator is requested by JES2 to set up the device as different setup requirements 
become necessary. Responding to demand setup requests is identical to responding to 
automatic setup requests. 



Assumed Data Set 
Characteristics 



Characteristics are assumed for any data set if they are not specified on the SYSOUT DD 
statement or the JES2 /*OUTPUT statement. Any FCB or UCS image that is specified as 
the default image by the installation is used to print any data set that does not specify an 
FCB or UCS parameter. JES2 uses the name **** when requesting from the operator a 
default FCB or UCS image. The operator satisfies this request by mounting any image 
specified as a default. If one or more of the parameters (FCB,UCS, form) is not specified, 
then any default image satisfies it. 
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The form used for all data sets not specifying a form is identified during JES2 initializa- 
tion (&STDFORM). This is the standard form for both printers and punches. 



Operation for Printers 



An installation generally has one or more printers (and/or punches) in manual setup 
(operator-controlled) mode for processing output that requires the most common 
combination (standard setup) of form, print train, and carriage control (and forms 
overlay and burster setting for the 3800 printer). The remaining printers are in automatic 
mode. Initially each printer is assigned setup characteristics and a set of output classes 
from which to select data sets. 



For each printer, data set groups are dequeued that have characteristics matching the 
printer setup characteristics. As automatic-mode printers exhaust the queue of data sets 
specifying their current setup, a data set group with a different set of characteristics is 
chosen, and the operator is notified (message HASP 190) to change the setup. 

An operator can respond to a request for a new setup change from a device in automatic 
mode by doing one of the following: 

• Execute the request and then issue the $S command to the device. 

• Allow the use of the setup only for the data set group that requested it, by issuing the 
$P command, followed by the $S command. The $P command causes the device to 
become idle after printing the current data set group. 

• Force an alternate setup on this data set group by issing the $T command, followed by 
the $S command. The device must be set up, however, and the $T and $S commands 
must be repeated for each data set in the group. Header and trailer pages are 
considered data sets for this sequence. 

• Cause the selection of an alternate data set group by holding ($H command) the job 
and then issuing the $1 or $E command, which causes the data set group to be 
requeued in a held state. The held group must be released later by the operator. 

• Delete the data set group by issuing the $C command to the device. Another data set 
group is then selected for the setup on this device, or another setup is requested. 

The operator can also change characteristics of a device in manual mode or change the 
mode of the device if the device is idle. 



Output Routing 



A user can route output to a specific local or remote device, to a remote job entry 
station, or to a pool of remote job entry stations. The user can route a specific data set by 
means of the DEST parameter on the DD statement, a specific data set or group of data 
sets by means of the /*OUTPUT statement, or the entire print/punch output for the job 
by means of the /*ROUTE statement. DEST cannot be used to route output for a 
specific device. 

If the destination for a data set is specifically stated on the /*OUTPUT statement, or by 
the DEST parameter, it is used. For data sets with no destination specified, the 
destination on the /*ROUTE statement or a default destination is used. The default print 
and punch destination may be specified on the reader from which the job was received. If 
not, the default destination becomes the location (LOCAL or RMTnnn) from which the 
job was received. 

The system programmer may specify a destination number (printer or punch) for each 
local and remote device and for each remote station during JES2 initialization. If a 
destination number is specified for any device, that device is eligible to receive only data 
which is specifically routed to it. 
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Processing Held Data 
Sets 



External Writers 



Destination names are of the form PRINTERn or PRINTRnn, PUNCHn, RMTnn, 
LOCAL. LOCAL indicates any device attached by a channel to the CPU. The n or nn is a 
numeric destination ID assigned to the device or remote station during initialization. The 
form PRINTERn must be used if the installation has fewer than ten printers; the form 
PRINTRnn must be used if ten or more printers are specified during JES2 initialization. 

By assigning the same destination ID to a group of remote stations or a group of devices, 
the system programmer can create a remote pool or device pool. 

A data set is explicitly held by the HOLD parameter of a DD statement or by specifying 
HOLD during dynamic allocation or deallocation. 

A data set can also be implicitly held if it is in a class that is held and the job's 
MSGCLASS is also a held class. Since for a data set to be implicitly held, both the class in 
which it is written and its MSGCLASS must be held classes (the $$x JES2 initialization 
parameter is used to specify held classes), a programmer can control the holding of data 
sets using only the MSGCLASS parameter. 

For the job described in Figure 4-6, assume that output classes A and M are defined as 
held at JES2 initialization; then: 

• Because MSGCLASS=A is specified, the SYSUT2 and SYSPRINT data will be held. 

• SYSUDUMP will not be held. 

• If the MSGCLASS were changed to C, none of the data would be held. 

• If this JCL is submitted through TSO, it can be held with MSGCLASS=A. The same 
JCL can be submitted from an RJE terminal with MSGCLASS=C and the output will 
be printed at the RJE station. 

A held data set is queued in a special queue. Job output elements are not built for a held 
data set. 

Held data sets are released either from a time-sharing terminal or by the operator's output 
command ($0). Only held data sets can be retrieved with the TSO OUTPUT command. 

After output is described by job output elements and queued in priority order in the job 
output table, the output can be written by a JES2 print/punch processor or an external 
writer. An external writer can be IBM-supplied external writer processor, or a user-written 
writer named on the SYSOUT DD statement. The operator starts an external writer in a 
private address space, and the data is written using QSAM. 

For details on the external writer, see 0S/VS2 System Programming Library: Job 
Management. 



//TSOUSER 


JOB 


name,MSG LEVEL = 1, MSGCLASS = A 






//STEP 


EXEC 


PGM = IEBGENER 






//SYSPRINT 


DD 


SYSOUT = A 






//SYSUDUMP 


DD 


SYSOUT = D 






//SYSUT1 


DD 


DSN = USERA.DSN1 .ASM,DISP = OLD 






//SYSUT2 


DD 


SYSOUT = M,DCB = (RECFM = F,LRECL = 


= 80,BLKSIZE = 


= 80) 


//SYS IN 


DD 


DUMMY 







Figure 4-6. Sample JCL for TSO-Submitted Job 
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/ Witers When SYSOUT data sets are to be written on 3540 diskettes, the 3540 diskette writer 

program must be used. See OS/VS2 IBM 3540 Programmer's Reference for details. 

,^^» reparation The JES2 writer writes separation records prior to writing the output of each job. These 

separation records make it easy to identify and separate the various job outputs that are 
written contiguously on the same printer or card punch device. 

For data processed by a JES2 writer, the JES2 separator pages are written before and 
after the writing of the output represented by one JOE. 

The JES2 Print Separator JES2 START JOB and END JOB separator pages consist of one-half page of blocked 

letters specifying the job name, job ID and output class; plus a single line of information 
duplicated as specified by each installation. All alphanumeric and all national characters 
are represented in blocked letter format. (The user specifies the total number of lines on 
the separator page. If less than thirty lines are specified, no blocked letters will appear.) 
The operator may request separator lines or cards via issuing a $T device,S=Y command. 
This function may be deleted by issuing a $T device ,S=N command. The default status is 
"S=Y" unless specified by an initialization option. 

The duplicated information lines contain data such as: 

• Output class 

• Keyword START, CONT, or END 

• Job ID (job number) 

• Job name 

• Programmer's name from JOB card 

• Room number from JOB card 

• Time this page was printed (hh.mm.ss AM/PM) 

• Date this page was printed 

• Device name 

• System ID 

The JES2 Punch Separator Each job's punched output is optionally preceded by an identification card. To make the 
Card card easy to identify, it has an 1 1-punch and a 12-punch in all 80 columns. To make the 

room number and job number easy to read, each digit is extended over ten columns. 

Alphabetic characters are converted to digits as follows: 



Alphabetic 
Characters 


Numeric 
Punch 


A or J 


1 


B, K or S 

C, L, or T 


2 
3 


D,M,orU 
E, N, or V 
F,0,orW 


4 
5 
6 


G, P, or X 
H, Q, or Y 
I, R, or Z 


7 
8 
9 
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Print Chain Alias for 
1403 and 3211 Printers 



The system assigns an alias for each installation-standard chain not actually defined on a 
given 1403 or 321 1 printer. This alias provides JES2 with flexibility in scheduling printers 
for SYSOUT data sets. For example, a request for the 1403 TN train would be assigned 
the Tl 1 train, if the data set were printed on a 3211. The assigned aliases, which follow 
the naming conventions currently used in SYS1.IMAGELIB, are: 

Image Alias 

CS1AN UCS1A11 

UCS1HN UCS1H11 

UCS1PN UCS1P11 

UCS1TN UCS1T11 

UCS2A11 UCS2AN 

UCS2H11 UCS2HN 

UCS2P11 UCS2PN, UCS2RN, UCS2QN 

UCS2T11 UCS2TN 



321 1 Indexing 



The image and aliases are included in SYS1.IMAGELIB at system generation. (See the 
DATAMGT macro in OS/VS2 System Programming Library: System Generation 
Reference. ) 

Some trains, such as SN and Gil, do not have aliases because they have no equivalent 
train on another printer. An installation can assign an alias, if it so chooses. (See OS/VS 
Linkage Editor and Loader for details about the ALIAS statement.) If an alias is supplied, 
JES2 uses it. If an alias is not supplied, an installation-defined SYSOUT class or a printer 
routing code (specified by the DEST parameter) should be used to assign the data set to 
the correct printer. If a SYSOUT class or a printer routing code is not used, and JES2 is 
directed to print a data set on a printer for which the proper image is not supplied, JES2 
notifies the operator. The operator can then print the data set with a valid train or 
redirect the data set to the proper printer by using the $E command. 

If an installation defines a new train, it can supply an alias for that train, using the linkage 
editor ALIAS statement, when including the image in SYS1.IMAGELIB. 

JES2 supports 321 1 indexing through the INDEX parameter on the /*OUTPUT card and 
the extended FCB image. With the extended FCB image, JES2 supplies two special FCBs: 
FCB26 for 6 lines per inch (lpi) and FCB28 for 81pi (specified as FCB=6 and FCB=8, 
respectively). These FCBs contain a channel 1 indication in position 1 , a special index flag 
in the third byte, and the number of lpi in the fourth byte of the image. The special index 
flag in the third byte of FCB26 and FCB28 contains X'80' plus a binary index value, in 
the range of 1 to 32 (if not specified, 1 is assumed). The index value sets the left-hand 
margin (1 indicates flush-left position; other values cause indentation of the print line by 
n-1 positions). 

If any other FCB images are to be used by JES2, they must specify channel 1 in position 
1 ; otherwise JES2 incorrectly positions the forms in the printer. (STD1 and STD2 do not 
specify channel 1 in position 1 and therefore must not be specified, unless altered, for 
JES2.) If the third byte of any other FCB image contains a data character (specifying the 
number of lpi) other than X'80', JES2 uses that specification and supplies an index value 
of 1. 
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CHAPTER 5. REMOTE JOB ENTRY 



Overview 



The remote job entry (RJE) support of JES2 allows remote facilities to use the job entry 
subsystem. JES2 processes remote jobs no differently than it does those received from 
local readers, printers, and punches. 

This chapter describes the characteristics of the remote devices supported by JES2 and 
the RMT generation for generating remote terminal processor (RTP) programs (including 
the parameters used and the processing of the generation). Some aspects of remote 
operations are also included in this chapter; for example, starting remote job entry and 
disconnecting remote lines. 



Remote job entry is the ability to submit jobs and receive system output at remote 
facilities as if the jobs had been submitted at a local facility. JES2 supports both SNA 
(systems network architecture) and BSC (binary synchronous communication) remote 
stations as RJE facilities. The remote facilities may be attached to JES2 by synchronous 
data link control (SDLC) or by a (point-to-point) BSC communication link. The remote 
facility becomes a logical extension of the local computer facility and is expected by 
JES2 to be under the control of a person called a remote operator. 

There are two types of remote job entry stations. The first type is the remote terminal, 
that does not have a CPU. A remote terminal, for example, a 2780 or 2770, can be used 
for entering jobs into and receiving data from JES2. The second type is a remote work 
station that does have a CPU. A processor, for example, System/3 or System/370, 
executes a JES2 generated program that allows the processor to send jobs to and receive 
data from JES2. Also part of the work station are printers, punches, card readers, and a 
console. A remote work station is established by a JES2 program, RMTGEN, during 
system generation or later. See "RMT Generation" below for a description Of the 
procedure and parameters used. A remote station is a composite term for a remote 
terminal and a remote work station. 

Reading, printing, and punching between the CPU and the remote terminal take place one 
action at a time. For example, it is either transmitting print data or transmitting punch 
data or reading an input stream. The remote operator may influence the order of these 
events. A discussion of how this is done is presented later in this section under, "Altering 
the Sequence of Operations from a Remote Terminal." 

SNA RJE Considerations: Remote job entry stations that use the facilities of an SNA 
network gain access to JES2 through VTAM. During VTAM system definition, these RJE 
stations (for example, the 3770 terminals and the System/32 workstation) are defined to 
VTAM as logical units (LUs) and physical units (PUs) by means of the VTAM LU and PU 
definition statements, respectively. The installation must decide at VTAM system 
definition how to tailor the JES2/VTAM support for its SNA stations, because the 
parameters of the LU and PU statements affect not only how JES2 operates, but also 
how the remote operator uses the station. 

Some of the LU parameters affect both the logon syntax and the handling of logon 
requests. For example, the installation can specify an interpret table (with the LOGTAB 
parameter) to use in assigning an alias for the JES2 application ID, or specify a table to 
use in generating a logon sequence (with the USSTAB parameter). The SSCPFM 
parameter allows the installation to specify whether the terminal supports formatted or 
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unformatted system services. Other LU parameters affect the VTAM session with JES2. 
For a description of what these parameters specify and how to code the LU definition 
statement, refer to OS/VS2 MVS System Programming Library: VTAM. 

The DISCNT parameter of the PU definition statement affects the disconnecting of the 
teleprocessing link. OS/VS2 System Programming Library: VTAM also describes this 
definition statement. 

Note: JES2 is concerned only with the RJE lines, which are the logical connections 
between JES2 and VTAM. The teleprocessing links (the physical connections) are 
transparent to JES2; they are managed exclusively by VTAM and the NCP. 

During the JES2 initialization procedure, the system programmer defines other 
characteristics of the SNA RJE stations and their JES2/VTAM support. The initialization 
parameter &NUMLNES includes the number of logical lines defined to JES2; 
&NUMTPBF includes the number of buffers required for stations supported by VTAM; 
and &TPBFSIZ includes the largest buffer specified for SNA stations. The initialization 
parameter L0G0N1 identifies JES2 as an application program to VTAM. 

The system programmer also defines the remote stations and the lines that the stations 
use. Each SNA RJE station is defined by means of an RMTnnn initialization parameter 
with the subparameter LUTYPE1. LUTYPE1 indicates to JES2 that it can communicate 
with the station only through a logical line. A logical line is defined by a LINEnnn 
initialization parameter with the subparameter UNIT=SNA specified. 

The system programmer does not specify the CONSOLE subparameter with the RMTnnn 
parameter because all SNA RJE stations support console input and output. JES2 
messages to the remote operator are sent to the console only between the times when 
data sets are outbound and when no inbound data sets are being transmitted. This timing 
arrangement is used so that console messages do not become interspersed in printed 
output when the console printer is not a separate printer in the station. When a separate 
console printer is available, all messages to the operator are routed to that printer. 

BSC RJE Considerations: Communication between the local CPU and BSC remote work 
stations uses a JES2 facility called MULTI-LEAVING that allows multiple print and 
punch streams to be transmitted at the same time and multiple console messages and 
input streams to be received by JES2. With MULTI-LEAVING, you can have several 
operations going simultaneously. Operators at remote terminals and at work stations that 
have no console can enter commands into the input stream in the normal manner. 
Command replies will be scheduled back to the remote station for printing on a remote 
printer. 

JES2 provides remote station MULTI-LEAVING support for the following programmable 
work stations: 

IBM System/360 Model 20, Submodels 2, 4, 5, and 6 and the 2922 with the following 
selectable options: 

1403 Printer 

1442 Card Read Punch 

2152 Printer-Keyboard 

2203 Printer 

2501 Card Reader 
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2520 Card Read Punch 

2560 Multi-Function Card Machine 

IBM System/360 Models 22 and up and System/370 Models 115, 125, 135, 145, 155, 
158, 165, 168, and 195 with the following selectable options: 

1052 Printer-Keyboard 

1403 Printer 

1442 Card Read Punch 

1443 Printer 
2501 Card Reader 
2520 Card Read Punch 
2540 Card Read Punch 
3203 Printer 

3210/3215 Console Printer-Keyboard (supported as a 1052) 
3211 Printer 

3504 Card Reader (supported as a 2501) 

3505 Card Reader (supported as a 2501) 
3525 Card Punch (supported as a 1442) 
5203 Printer 

5313 Console for the Model 125 (requires 1052 compatibility feature). 

(Note: System/370 RMS support is not provided.) 

IBM 1 130 System with the following selectable options: 
1132 Printer 
1403 Printer 
1442 Card Read Punch 
1442 Card Punch 
2501 Card Reader 
Standard Printer-Keyboard 

IBM System/3 Model 10 with the following selectable options: 
1442 Card Read Punch 
5203 Printer 

5424 Multi-Function Card Unit 
5471 Printer-Keyboard 
5475 Data Entry Keyboard 

For Both SNA and BSC RJE Stations: Remote lines can be configured as dedicated or 
nondedicated. This configuration is established during initialization when the remote 
stations are specified. If the station parameter, RMTnnn, designates a line number, the 
line is dedicated to that station. If two or more RMTnnn parameters specify the same 
line, the stations corresponding to those parameters must contend for use of that line, 
lines that are not pointed to by a station parameter at initialization are nondedicated 
lines and are eligible to be dynamically connected to any nondedicated station. 
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RMT Generation 



Remote stations that are not physically connected to the CPU, that is, stations that must 
be connected via dial facilities, normally do not specify a dedicated line so that the 
station may be connected to any available nondedicated line. There are other reasons for 
specifying a line as nondedicated even if the line is physically connected to a remote 
station: 

• For BSC remote stations, a sign-on card is not required for connecting stations to 
dedicated lines, and is ignored, since the station is considered active when the line is 
started. Therefore, line and station password authorization is only enforced for 
nondedicated lines and stations. (SNA stations never use the sign-on card.) 

• For both SNA and BSC stations, one physically connected station can be initialized as 
multiple nondedicated stations for use by different groups or at different times. The 
period of use of each such logical station would be defined by sign-on and sign-off 
(LOGON and LOGOFF for SNA RJE stations). Data routed to the logical station will 
only be transmitted while that logical station is signed on. 

• For both SNA and BSC stations, if remote stations are initialized as nondedicated, one 
remote station can be used as backup for an inoperable station by being signed on with 
the inoperable station's ID. 

• For BSC stations, a station attached to a dedicated line is considered active whenever 
the line is active. Line activation is under control of the central operator. The central 
operator is not aware of station usage in this case. (He is aware of station usage when 
nondedicated stations are signed on and off by the console). Also, JES2 allocates 
resources for remote lines while they are active, which is only between sign-on and 
sign-off for nondedicated lines. 

One advantage in specifying lines as dedicated for a BSC remote station is that the station 
can be used without signing on the station, a manual process at all remote terminals. 

It is possible to configure lines and stations that must be connected by dial facilities as 
dedicated. However, there can be only one station ID and set of station characteristics 
associated with the dedicated line. 

An installation can also establish a relationship between stations and nondedicated lines 
by means of line passwords. A line password, defined by the LINEnnn initialization 
parameter, guarantees a user or group of users the use of a particular line and prevents 
unauthorized remote operators from using that line to gain access to JES2. 



RMT generation is the JES2 procedure for generating MULTI-LEAVING remote terminal 
processor (RTP) programs for remote job entry from programmable remote workstations. 
These programs allow MULTI-LEAVING workstations (see the list of workstations 
above) to operate as remote workstations with JES2. RMT generation requires other 
procedures for its processing; for example, procedures for allocating space and cataloging. 
It also requires certain spool data sets for job processing after generation. These 
procedures and data sets, also required by JES2 generation, are described in Chapter 2. 

The following sections describe the RMT parameters used and the processing involved in 
an RMT generation. 



Specifying RMT 
Parameters 



If RTP programs are to be generated, parameters that define those programs must also be 
specified. Additionally, if changes are to be made to the RTP program source modules, 
these changes must be specified in control statements. 
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RMT Parameters 



For an RMT generation, the input deck contains one or more RTP program descriptions. 
Each terminal program to be generated is described by card entries in the following order: 

1. JES2 remote terminal processor program identification 

2. RMT generation parameter cards 

3. $.UPDATE control card (optional) 

4. Update cards if $. UPDATE is specified 

5. $.RMTEND end of RMT generation description 

Each parameter is coded, beginning in column 1, in the format 

parameters due 

parameter represents a valid option specified in the appropriate RTP program options 
section (see "RMT Parameter Descriptions"). 

value represents a character string of up to seventeen characters. 

The parameter cannot have embedded blanks. Comments can be included in a parameter 
statement but they must be separated from the value by one or more blanks. 

RMT generation parameters may appear in any order after the RTP program 
identification card. If the same parameter occurs more than once in the input deck, the 
last occurrence determines the parameter value. 



RMT Control Cards 



The general format for RMT control cards is: 



Columns 

1-2 
3-71 



73-80 



Field 



operands 



ignored 



Description 

Control card identification 

Variable length, separated by a comma and containing no 

embedded blanks (the last operand must be followed by a 

blank). 



The first card in the RMT generation input deck is a JES2 remote terminal processor 
program identification card. It serves two functions: 

• Selects the appropriate standard options group and source member from 
SYS1.HASPSRC 

• Sets the remote terminal identification number 

The card format is: 

%.name,n 

name is the name of the RTP program to be generated (see Figure 5-1). 

n is a terminal number, one to three digits, that 'specifies the remote sign-on number 
(the first digit cannot be 0). This number must be followed by a blank. 

There are two additional RMT control cards: 

• $.UPDATE, which sets the update mode and causes the cards following this card to be 
used to modify the RTP program source modules for the current generation 
description 

• $.RMTEND, which is required to signal the end of the RMT generation description 
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JES2 Remote Terminal Terminal Program Identification Card 

Processor Program for (First Card of Each Remote Description) 

System/360 Model 20, 2922 $.RMTM20/j 
System/360 (other than Model 20) 

or System/370 $.RMT360/» 

1130 Loader $.RTPLOAD/? 

1130 $.RTP1 130^7 

System/3 $.RMTSYS3/j 

where /?=remote sign-on number 
Figure 5-1. RTP Program Identification Cards 

RMT Update Control The update control cards may be used only during an update run, after a $.UPDATE 

Cards CARD. The format of an update control card is: 

./ DELETE SEQl=seriall,SEQ2=serial2 

The symbols ./ are in columns 1 and 2. One or more blanks must precede and follow the 
word DELETE. There are no blanks between seriall and seriate; serial 1 indicates the 
starting card serial number, and seriate indicates the ending card serial number. 

The DELETE card is used to delete one or more source card images from the source code 
of the described RTP program (see "RMT Control Cards") as the source code is being 
prepared for the assembler. The DELETE card may be mixed -with insertion and 
replacement update cards containing new source statements for the assembler (see "RMT 
Update Cards" below). When a DELETE control card is specified, the source card images 
for the RTP program, starting with the serial number specified in SEQ1 through and 
including the serial number specified in SEQ2, are omitted from the assembler input 
source. ENDUP terminates the remote terminal program description. It may be replaced 
by $ .RMTEND, which also serves this function. 

RMT Update Cards Update cards are assembly language source cards in the format described in OS/VS- 

DOS/VS-VM/370 Assembler Language. Each card may be serialized in columns 73 
through 80 or may have blanks in columns 73 through 80. Cards with blank serial 
numbers are inserted in the source deck after the last serialized input card or, if following 
a DELETE control card, in place of the deleted source cards. All serialized input, 
including DELETE control cards, must have the serial numbers in ascending order. 



120 



RMT Parameter 
Descriptions 



The following subsections describe the parameters for each of five different types of 
RMT generations: System/360 (models other than Model 20) and System/370 binary 
synchronous communication (BSC) remote terminal processor program, System/360 
Model 20 binary synchronous communication (BSC) remote terminal processor program 
(including the 2922), 1 130 remote terminal processor program, 1 130 loader program, and 
System/3 remote terminal processor program. 

Refer to the overview at the beginning of this chapter for the devices that are supported 
in each type of remote workstation. 

The following conventions are used in this manual to describe the RMT parameters: 

• The RMT parameters for each RTP program are discussed in alphanumeric order; the 
first character is ignored if it is & or $. 

• Letters and numbers in bold type must be coded as shown. 

• Lowercase letters in italics represent variables for which you must substitute specific 
information or specific values. 

• If an alternative item is underlined, it is the default value. This value will be used 
automatically if the parameter is not specified. 



RMT Parameters for the 
System/360 Model 20 
BSC RTP Program 



This section describes the parameters used to specify the machine configuration and 
programming options required in the assembly of the System/360 Model 20 BSC remote 
terminal processor program for JES2 MULTI-LEAVING remote job entry. 



Parameter 
&CCT= 



&CMPTYPE= 



&CORESIZ= 



Value Explanation 

number is an integer from 3 to 3 1 that specifies, for all text 

4, compression (except trailing blank compression), the 

minimum number of characters to be compressed. 

A duplicate character string of fewer than the number 
specified is treated as a string of nonduplicate charac- 
ters for compression purposes. 

If a small value is specified, efficiency of communica- 
tion line usage is increased at the expense of the 
compute time that is required for compression. 

If the &CMPTYPE parameter is specified as 1 , this 
parameter is ignored. 

1 specifies the type of compression to be applied to all 

2 data transmitted from the Model 20 to JES2. 
3 

1 specifies trailing blank compression 

2 specifies compression of leading, embedded, and 
trailing blanks 

3 specifies compression of all duplicate character 
strings 

If this parameter is specified as 1 , the &CCT param- 
eter is ignored. 

number is an integer from 8 to 32 that specifies the size of 

8 Model 20 main storage in IK bytes (IK bytes equals 

1024 bytes). 
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&ERRMSGN= 


number 




10 


&LINESPD= 


number 




2000 


&MLBFSIZ= 


number 




400 



Parameter Value Explanation 

&CORESIZ= This parameter must never be greater than the actual 

(continued) storage size of the object machine. Warning: It is 

possible to specify combinations of parameters such 
that the resulting workstation program is too large 
for the available storage (&CORESIZ=255). Such a 
program will fail to load into the object machine. 



is a value greater than or equal to 8 that specifies the 
number of 4-byte entries to be assembled in the 
Model 20 RTP program as an error message log table. 

is an integer that specifies the speed, in bits per sec- 
ond, of the communication line to be used between 
the Model 20 and JES2. 

specifies the size, in bytes, of each JES2 MULTI- 
LEAVING buffer. This value must match the 
&MLBFSIZ initialization parameter value used by the 
JES2 program operating with the controlling MVS 
system. 

The parameter &MLBFSIZ is further described in 
Chapter 3. 



&NUMBUFS= number specifies the number of teleprocessing buffers to be 

8 constructed by the Model 20 RTP program. The 

specification must be an integer no less than: 

2X+1 
where: 

X = 1 , if either a 2520 or a 2560 is to be used as both 

a reader and a punch 
X = 0, if a 2520 or a 2560 is not to be used as both a 

reader and a punch 

The length of each buffer is the value specified in the 
&MLBFSIZ parameter plus 5 bytes (rounded upward 
to the next fullword). 

If this parameter specifies more buffers than can be 
built in available storage, the RTP program will build 
as many buffers as it can. 

It is recommended that at least two buffers be pro- 
vided for each output device and for the communica- 
tion adapter. 

&NUMTANK= number is an integer greater than or equal to 2 that specifies 

8 the number of decompression buffers to be assembled 

in the Model 20 RTP program. It is recommended 
that at least two buffers be provided for each printer 
and punch. 

The length of each decompression buffer is the value 
specified in the &PRTSIZE parameter plus 6. 
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Parameter 

&NUMTANK= 
(continued) 



&PDEV(1)= 



&PRTCONS= 



Value 



devtype 
2203 



r 

2 



Explanation 

For an 8K Model 20, specifying this parameter 
greater than 8 may cause the RTP program to 
assemble more than X'IFOO' bytes (8K - 256). 
If this occurs, the resultant program will fail to load. 

specifies the device type for the Model 20 printer. 
The specification must be either 1403 or 2203. 

specifies the usage of the printer as an output console. 
This parameter is dependent upon the specifications 
given during JES2 initialization that pertain to the 
handling of messages for the remote. 

If JES2 is informed, by means of the BMTnnn param- 
eter at JES2 initialization, that the remote has a 
console, &PRTCONS should be specified as one of 
following: 

specifies that error logging and display will be 
suppressed and operator messages that are created 
while the remote is online to JES2 will be 
discarded. 

1 specifies that the printer will be used as an output 
console when sufficient operator messages from 
JES2 have been queued for output at the remote. 
If the printer is busy with job stream output, 
that output will be interrupted for the printing 
of operator messages from JES2 and from the 
remote error log. When the console queue is 
empty, job stream output will continue. 

2 specifies that the printer will be used as an output 
console but will not interrupt the printing of jobs. 
Operator messages received from JES2 while jobs 
are being printed will be discarded. 

If JES2 is informed, by means of the BMTnnn param- 
eter at JES2 initialization, that the remote does not 
have a console, and if JES2 does not have message 
spooling capability (as determined by the JES2 
initialization parameter &SPOLMSG), &PRTCONS 
should be specified as follows: 

specifies that error logging and display will be 
suppressed (JES2 will not return operator 
messages" to the workstation). 

1 or 2 specifies that error log messages will be 

displayed when the printer is free to print 
them and no job's printed output will be 
interrupted. 

If JES2 is informed, by means of the RMTnnn param- 
eter at JES2 initialization, that the remote does not 
have a console and if JES2 has message spooling 
capability (as determined by the JES2 initialization 
parameter &SPOLMSG), &PRTCONS should be 
specified as if the remote did not have a console and 
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Parameter Value Explanation 

&PRTCONS= JES2 did not have message spooling capability (the 

(continued) second specification, above). The definitions are 

the same but with an additional capability in that 
operator messages queued for the remote by JES2, 
transmitted to the remote when the printer is free, 
and set to receive messages (via the $TRr.PRl 
command) are printed. 

If &WDEV(1) is not specified as 0, this parameter 
should be set to 0. 

Regardless of the settings of &WDEV(1) and this 
parameter, error messages resulting from loggable 
errors detected by the remote will be discarded when 
the errors occur at a rate that is faster than the output 
device can display them. 

Refer to the &SPOLMSG and &WDEV( 1 ) parameters 
for additional information. 

&PRTSIZE= number specifies the length, in bytes, of the text portion of 

120 each decompression buffer. Each buffer must be 

long enough to hold a maximum-length output 
record for either the printer, the punch, or the 
operator console. The specification must be an 
integer that is the largest of 80 (if &UDEV(1 ) is not 
0), 120 (if &WDEV(1) is not 0), or the line width of 
the printer. 

&RADR(1) unitadr specifies the unit address of the Model 20 card reader. 

1. The specification must correspond to the specifica- 

tion for the &RDEV(1) parameter as follows: 

&RDEV(1) &RADR(1) 

2501 1 

2520 2 

2560 2 

This parameter should not be altered when generating 
a 2922 work station program. 

&RDEV(1)= devtype specifies the device type for the Model 20 card reader. 

2501 The specification must be either 2501 , 2520, or 

2560. 

This parameter should not be altered when generating 
a 2922 work station program. 

Refer to the &RADR(1) parameter for additional 
information. 

&SUBMOD= submodel specifies the submodel number of the Model 20 for 

2 the specified remote terminal. The specification must 

be a valid System/360 Model 20 submodel number. 

This parameter should not be altered when generating 
a 2922 work station program. 
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Parameter 


Value 


Explanation 




&UADR(1)= 


unitadr 
3 


specifies the unit address of the Model 20 card punch. 
The specification must correspond to the specification 
of&UDEV(l) as follows: 






&UDEV(1) 

1442 
2520 
2560 



&UADR(1) 

3 
2 
2 
not present 


&UDEV(1)= 


devtype 
1442 


specifies the device type for the Model 20 card punch. 
The specification must be either 1442, 2520, 2560, or 



&WDEV(1)= 



devtype 




0. Specify when the Model 20 does not include a 
card punch. 

Specify &UDEV(1)=0 for the 2922, unless the RPQ 
punch is included (in which case &UDEV(1) should 
not be altered). 

Refer to the &UADR(1) parameter for additional 
information. 

specifies the device type for Model 20 console. The 
specification must be either 2152, if a console is 
present, or 0, if a console is not present. 

If a console is present, console support should be 
indicated for this remote terminal at JES2 
initialization. 



&WTOSIZE= 



number 
120 



&XPARENT= 



NO 
YES 



is an integer less inan or equal to 120 that specifies 
the maximum length, in bytes, of a JES2 operator 
command to be transmitted from the Model 20 to the 
central computer. 

If &WDEV(1) is specified as 0, this parameter is 
ignored. 

specifies the inclusion or exclusion of support for the 
text transparency feature. If the binary synchronous 
communication adapters at both the Model 20 and 
the central computer have the text transparency 
feature, YES should be used; otherwise, NO should be 
specified. 



RMT Parameters for the 
2922 Remote Work 
Station RTP Program 



This section describes the parameters used to specify the machine configuration and 
program options required in the assembly of the 2922 remote terminal processor program 
for JES2 MULTI-LEAVING remote job entry. 

To install a 2922 RTP program, the parameters and procedures for the System/360 Model 
20 BSC should be used, subject to the following specific parameter setting: 

&LINESPD=x;tx where xxx is the actual line speed used. 

&PDEV(1)=1403 

&PRTSIZE=132 

&UDEV(1)=0 
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&WDEV(1)=2152, if the optional typewriter console is installed. 
&XPARENT=NO, if the optional text transparency feature is not installed. 

The default values should be used for the following parameters: 

&CORESIZ= 
&RADR(1)= 
&RDEV(1)= 
&SUBMOD= 
&UADR(1)= 

The remaining Model 20 BSC parameters may be allowed to default or may be changed. 



RMT Parameters for the 
System/360 (Except 
Model 20) and System 
370 BSC RTP Program 



This section describes the parameters used to specify the machine configuration and 
program options required in the assembly of the System/360 and System/370 BSC 
remote terminal processor program for JES2 MULTI-LEAVING remote job entry. 



Parameter 
&ADAPT= 



Value 

unitadr 
020 



Explanation 

specifies the unit address of the binary synchronous 
communication adapter used by the System/360 or 
System/370 remote terminal to communicate with 
JES2 at the central computer. The specification 
must be a valid unit address. 



&CCT= 



number 
4 



&CMPTYPE= 



&CORESIZ= 



is an integer from 3 to 31 that specifies, for all 
text compression (except trailing blank compres- 
sion), the minimum number of characters to be 
compressed. 

A duplicate character string of fewer than the 
number specified is treated as a string of non- 
duplicate characters for compression purposes. 

If a small value is specified, efficiency of communi- 
cation line usage is increased at the expense of the 
compute time that is required for compression. 

If the &CMPTYPE parameter is specified as 1 , this 
parameter is ignored. 

specifies the type of compression to be applied to 
all data transmitted from the System/360 or 
System/370 remote terminal to JES2. 



1 specifies trailing blank compression 

2 specifies compression of leading, embedded, and 
trailing blanks 

3 specifies compression of all duplicate character 
strings 

If this parameter is specified as 1 , the &CCT parameter 
is ignored. 

number is an integer from 8 to 32 that specifies the size of 

8 main storage for the System/360 or System/370 

remote terminal in IK bytes (IK byte equals 1024 
bytes). If the System/360 or System/370 remote 
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Parameter 


Value 


&CORESIZ= 




(continued) 




&ERRMSGN= 


number 




10 



Explanation 

terminal is larger than 32K bytes, this parameter 
must be specified as 32. 

is a value greater than or equal to 8 that specifies the 
number of 4-byte entries to be assembled as an error 
message log table in the System/360 or System/370 
remote terminal. 



&LINESPD= number is an integer that specifies the speed, in bits per sec- 

2000 ond, of the communication line to be used between 

the System/360 or System/370 remote terminal and 
JES2. 

&MACHINE= model specifies the model number of the System/360 or 

30 System/370 to be used as a JES2 remote terminal. 

The specification must be a valid number for a 
System/360 or System/370 that includes the standard 
instruction set and the decimal instruction set. 

&MLBFSIZ= number specifies the size, in bytes, of each JES2 MULTI- 

400 LEAVING buffer. This value must match the 

&MLBFSIZ initialization parameter value used by the 
JES2 program operating with the controlling MVS 
system. 

The parameter &MLBFSIZ is further described in 
Chapter 3. 

&NUMBUFS= number specifies the number of teleprocessing buffers to be 

8 constructed by the System/360 or System/370 remote 

terminal program. The specification must be an integer 
no less than: 

2X+1 
where: 

X = n, the number of 2520 or 1442 units to be used 
as both readers and punches 

X = 0, if neither a 2520 nor a 1442 is to be used as 
both a reader and a punch 

The length of each buffer is the value specified in the 
&MLBFSIZ parameter plus 5 bytes (rounded upward 
to the next fullword). 

If this parameter specifies more buffers than can be 
built in available storage, the RTP program will build 
as many buffers as it can. 

It is recommended that at least two buffers be pro- 
vided for each output device and for the communica- 
tion adapter. 

&NUMTANK= number specifies the number of decompression buffers to be 

5. assembled in the System/360 or System/370 RTP 

program. The specification must be an integer 
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Parameter Value Explanation 

&NUMTANK= greater than zero and not less than 2(number of 2540 

(continued) punches attached). 

The length of each decompression buffer is the value 
specified in the &PRTSIZE plus 6. 

It is recommended that at least two decompression 
buffers be provided for each printer and each punch 
(three buffers for a 2540 punch). 

&PADR(«)= unitadr specifies the unit address of each remote terminal 

printer defined by the &PDEV(«) parameter. The n 
is a sequential number (1 -7) that you code to identify 
each device being specified. 

For each &PDEV(«) parameter that is not specified as 
0, the corresponding parameter &PADR(«) must 
specify the device's three-character hexadecimal unit 
address. 

All devices at the remote terminal workstation must 
be on separate non-shared subchannels (that is, all 
I/O devices must be capable of running simultaneous- 

iy). 

If this parameter is not specified, the following values are 
are used as defaults: 

&PADR(1)=00E 
&PADR(2)=00F 
&PADR(3)=FFF 
&PADR(4)=FFF 
&PADR(5)=FFF 
&PADR(6)=FFF 
&PADR(7)=FFF 

&PDEV(«)= devtype specifies the existence and device type of each remote 

terminal printer. The specification must be either 
1403, 1443, 321 1, 3203, 5203, or 0. A specification 
of indicates that the associated printer does not 
exist. The n is a sequential number (1-7) that you 
code to identify each device being specified. 

If this parameter is not specified, the following values 
are used as defaults: 

&PDEV(1)=1403 

&PDEV(2)=0 

&PDEV(3)=0 

&PDEV(4)=0 

&PDEV(5)=0 

&PDEV(6)=0 

&PDEV(7)=0 

&PDEV(1) must not be specified as 

If &PDEV(«+1) is specified as a device type, 
&PDEV(«) must be specified as a device type. 
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Parameter Value Explanation 

&PDEV(«)= If &PDEV(«) is specified as a device type, 

(continued) &UDEV(8-«) must be specified as 0. 

If more than one printer is specified, more than one 
printer should also be specified in the RMT««« 
parameter at JES2 initialization. 

&PRTSIZE= number specifies the length, in bytes, of the text portion of 

132 each decompression buffer. Each buffer must be long 

enough to hold a maximum-length output record for 
either a printer, a punch, or the operator console. The 
specification must be an integer that is the larger of 
120 or the line width of the widest printer. 

&RADR(«)= unitadr specifies the unit address of each remote terminal 

card reader defined by the &RDEV(«) parameter. 
The n is a sequential number (1-7) that you code to 
identify each device being specified. 

For each &RDEV(«) parameter that is not specified 
as 0, a corresponding parameter &RADR(n) must 
specify the device's three-character hexadecimal unit 
address. 

All devices at the remote terminal workstation must 
be on separate nonshared subchannels (that is, all I/O 
devices must be capable of running simultaneously). 

If this parameter is not specified, the following values 
are used as defaults: 

&RADR(1)=00C 
&RADR(2)=FFF 
&RADR(3)=FFF 
&RADR(4)=FFF 
&RADR(5)=FFF 
&RADR(6)=FFF 
&RADR(7)=FFF 

&RDEV(«)= devtype specifies the existence and device type of each remote 

terminal card reader. Each specification must be either 
1442, 2501, 2520, 2540, or 0. A specification of 
indicates that the associated remote terminal card 
reader does not exist. The n is a sequential number 
(1-7) that you code to identify each device being 
specified. 

If this parameter is not specified, the following values 
are used as defaults: 

&RDEV(1)=2540 

&RDEV(2)=0 

&RDEV(3)=0 

&RDEV(4)=0 

&RDEV(5)=0 

&RDEV(6)=0 

&RDEV(7)=0 
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Parameter 

&RDEV(«)= 

(continued) 



&UADR(«)= 



&UDEV(n)= 



Value Explanation 

&RDEV(1) must not be specified as 0. 

If &RDEV(«+1) is specified as a device type, 
&RDEV(«) must be specified as a device type. 

If more than one reader is specified, more than one 
reader should also be specified in the RMTnnn 
parameter at JES2 initialization. 

unitadr specifies the unit address of each remote terminal 

punch defined by the &UDEV(«) parameter. The n is 
a sequential number (1-7) that you code to identify 
each device being specified. 

For each &UDEV(«) parameter that is not specified 
as 0, the corresponding parameter &UADR(h) must 
specify the device's three-character hexadecimal unit 
address. 

All devices at the remote terminal workstation must 
be on separate nonshared subchannels (that is, all I/O 
devices must be capable of running simultaneously). 

If this parameter is not specified, the following values 
are used as defaults: 

&UADR(1)=00D 
&UADR(2)=FFF 
&UADR(3)=FFF 
&UADR(4)=FFF 
&UADR(5)=FFF 
&UADR(6)=FFF 
&UADR(7)=FFF 

devtype specifies the existence and device type of each remote 

terminal punch. The specification must be either 1442, 
2520, 2540, or 0. A specification of indicates that 
the associated punch does not exist. The n is a sequen- 
tial number (1-7) that you code to identify each device 
being specified. 

If this parameter is not specified, the following are 
used as defaults: 

&UDEV(1)=2540 

&UDEV(2)=0 

&UDEV(3)=0 

&UDEV(4)=0 

&UDEV(5)=0 

&UDEV(6)=0 

&UDEV(7)=0 

If &UDEV(n+l) is specified as a device type, 
&UDEV(«) must be specified as a device type. 

If &UDEV(«) is specified as a device type, 
&PDEV(8-«) must be specified as 0. 
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Parameter 


Value 


&UDEV(«)= 

(continued) 




&WADR(1)= 


unitadr 
OIF 



Explanation 

If more than one punch is specified, more than one 
punch should also be specified in the RMInnn 
parameter at JES2 initialization. 

specifies the unit address of the 1052 or 1052- 
compatible operator console on the System/360 or 
System/370 remote terminal. The specification must 
be a three-character hexadecimal unit address. 



&WTOSIZE= number is an integer less than or equal to 120 that specifies 

120 the maximum length, in bytes, of a JES2 operator 

command to be transmitted from the System/360 or 
System/370 remote terminal to JES2. 

&XPARENT= NO specifies the inclusion or exclusion of support for the 

YES text transparency feature. If the binary synchronous 

communication adapters at both the System/360 or 
System/370 remote terminal and the central computer 
have the text transparency feature, the default value 
should be used; otherwise, NO should be specified. 



RMT Parameters for the 
1 130 RTP Program 



This section describes the parameters used to specify the machine configuration and 
program options required in the assembly of the 1 130 remote terminal processor program 
for JES2 MULTI-LEAVING remote job entry. 



Parameter 
&CLOCK= 



Value 


1 



Explanation 

specifies the type of communication adapter clocking 
available on the 1 130. 

specifies that data set clocking is being used, and 

1 specifies internal 1130 clocking. 

The rate of insertion of the synchronous idle sequence 
in the transmitted data is determined by the &CLOCK, 
&LINESPD, and &TRANPRN parameters. The rela- 
tionship of these parameters to the insertion rate is: 

&CLOCK &TRANPRN Insertion Rate 









Every &LINESPD/8 
characters 





1 


Every &LINESPD/8 
characters 


1 

1 




1 


Every 70 characters 
Every &LINESPD/8 
characters 



The equation used for the insertion rate is: 
(&LINESPD/8)T 

where T is 1 .00 second, which is the nominal 2701 
time value. 



&CMPTYPE= 



specifies the type of compression to be applied to all 
data transmitted to JES2. 



Chapter 5. Remote Job Entry 131 



Parameter Value Explanation 

&CMPTYPE= specifies no compression of duplicate characters 

(continued) and no truncation of trailing blanks. 

1 specifies trailing blank truncation. 

2 specifies full compression, trailing blank truncation 
and encoding of duplicate characters. 

The process of compressing input data offers 
optimum performance with respect to efficient line 
utilization. However, factors such as line speed, CPU 
availability, buffer size, line turnaround time, and 
nature of the data to be compressed contribute to the 
overall operation of the RTP program. Since compres- 
sion and truncation require considerable CPU time, 
you may decide, on the basis of the other variables, 
to respecify the compression technique. 

&DELAY= number specifies the number of time intervals that the RTP 

3. program will delay in transmitting a "handshaking" 

sequence (DLE-ACKO) to the central computer. The 
machine program timer clock is used to measure the 
delay and is assumed to be set to a minimal value of 
0.35 seconds. 

The purpose of the delay when "handshaking" is to 
minimize CPU processing at the central computer 
when no data is being transmitted. 

Using the default value results in a delay of 1 .05 
seconds, assuming a timer interval of 0.35 seconds. 

The value of this parameter must not be set to such a 
large increment that the delay will be greater than the 
time-out period of the central computer's 2701/2703. 

&FULLIST= specifies the type of assembly listing produced by the 

! OS/VS assembler during RMT generation. 

specifies that the assembly listing will be produced 
according to the PRINT NOGEN stipulation of the 
assembler, and 

1 specifies that the listing will be produced according 
to the PRINT GEN stipulation. 

Since most of the code in the RTP1 130 and RTPLOAD 
programs is created by macro instructions, the specifi- 
cation of will, essentially, produce a source listing 
(cross-referenced) without the 1 130 assembled 
instructions. 

&LINESPD= number is an integer that specifies the speed, in bits per second, 
2000 of the communication line to be used between the 
1 130 and central computer. The value should corres- 
pond to the selected setting of the baud rate switch 
on the 1 130 SCA control panel: 1200, 2000, 

The rate of insertion of the synchronous idle sequence 
(DLE-SYN or SYN-SYN) in the transmitted data is 
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Parameter 


Value 


&LINESPD= 




(continued) 




&MACHSIZ= 


number 




8192 



&MLBFSIZ= 



number 
400 



&PN1442= 



Explanation 

determined by the &CLOCK, &LINESPD, and 
&TRANPRN parameters. Refer to the &CLOCK 
parameter for the relationship of these parameters. 

specifies the amount of 1 130 storage to be used by the 
RTP program. The value is specified in 1 130 words. 

The value specifies the number of words, starting at 
location 0, that are available to the RTP programs 
(RTPBOOT, RTPLOAD, and RTP1 130). The value 
specified may be less than the actual available storage 
but must not be greater. 

The same parameter must be defined for the assembly 
of the 1130 loader program and should have the same 
value. 

specifies the size, in bytes, of each JES2 MULTI- 
LEAVING buffer. This value must match the 
&MLBFSIZ initialization parameter value used by the 
JES2 program operating with the controlling MVS 
system. 

The parameter &MLBFSIZ is further described in 
Chapter 3. 

specifies the inclusion or exclusion of support for the 
1442 punch in the RTP program. 

specifies that support is not to be included, and 

1 specifies that support for punched card output 
produced by jobs at the central computer is to be 
included. 

Refer to the &RD1442 parameter for information 
about the reader function of the 1442. 



&PRFOTLW= 


120 
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&PR1132= 







1 



&PR1403 



&RD1442= 



specifies the line width of the 1403 printer. 

The specification of the line width for all printers on 
a remote terminal is a JES2 installation requirement. 

specifies the inclusion or exclusion of the support for 
the 1 132 printer in the RTP program. 

specifies that support is not to be included, and 

1 specifies that support for printing job output using 
the 1 1 32 is to be included. 

specifies the inclusion or exclusion of the support for 
the 1403 printer in the RTP program, where: 

specifies that support is not to be included, and 

1 specifies that support is to be included. 

specifies the inclusion or exclusion of the support for 
a 1442 card reader in the RTP program. 
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Parameter 

&RD1442= 

(continued) 

&RD2501= 



&RTPLORG= 



Value 



number 



&TRANPRN= 



Explanation 

specifies that support is not to be included, and 

1 specifies that support is to be included. 

specifies the inclusion or exclusion of the support for 
the 2501 card reader in the RTP program. 

specifies that support is not to be included, and 

1 specifies that support is to be included 

defines the location in 1 130 storage of the RTPLOAD 
program, which is used to load the 1 130 RTP program. 
If this parameter is not specified, the default value is: 

2(&MACHSIZ - 1024) 

The RTPLOAD program must reside in an area of 
storage that is available between the beginning of the 
buffer pool and the end of main storage, as defined in 
the &MACHSIZ parameter, minus the length of the 
RTPLOAD program. The default value of this 
parameter allows 1024 words for the RTPLOAD 
program. 

Assuming &MACHSIZ=8192, the default value is 
14336. This value is twice the actual 1130 storage 
address because the value is used in an ORG operation 
and must be in terms of bytes, not 1 130 words. 

specifies the simulation of the binary synchronous 
transparency feature. 

specifies that no simulation will occur. In this case, 
data containing transparent characters cannot be 
properly processed by the RTP program. 

1 specifies that simulation will occur in the same 
manner as the 2701 SDA-II adapter that is equipped 
with the transparency feature. 

If is specified, the conversion of card code data is 
monitored and all BSC control characters are converted 
to hexadecimal 0. This prevents mispunched data 
from causing an infinite error retry if the central 
computer does not have transparency. 

If 1 is specified, the RTP program will communicate 
only with a 2703 or with a 2701 adapter that has the 
text transparency feature. 



RMT Parameters for the 
1 130 Loader Program 



This section describes the parameters used to specify the machine size, loader origin, and 
assembly list option that are used in the assembly of RTPLOAD, the 1130 loader 
program, that loads the 1 130 remote terminal processor program. 

RMT generation produces the object decks for the RTPLOAD and RTP1130 programs. 
The bootstrap loader program (RTPBOOT) cannot be produced on System/360 or 
System/370 and must be keypunched as indicated in the RTP section of OS/VS2 MVS 
JES2 Logic. 



134 



Parameter 
&FULLIST= 



Value 


1 



&MACHSIZ= 



number 
8192 



&RTPLORG= 



number 



Explanation 

specifies the type of assembly listing produced by the 
OS/VS assembler during the RMT generation. 

specifies that the assembly listing will be produced 
according to the PRINT NOGEN stipulation of the 
assembler, and 

1 specifies that the listing will be produced according 
to the PRINT GEN stipulation. 

Since most of the code in the RTP1 130 and 
RTPLOAD programs is created by macro instructions, 
the specification of will, essentially, produce a 
source listing (cross-referenced) without the 1 130 
assembled instructions. 

specifies the amount of 1 130 main storage to be used 
by the RTP program. The value is specified in 1 130 
words. 

The value specifies the number of words, starting at 
location 0, that are available to the RTP programs 
(RTPBOOT, RTPLOAD, and RTP1 130). The value 
-specified may be less than the actual available storage 
but must not be greater. 

The same parameter must be defined for the assembly 
of the 1 130 RTP program and should have the same 
value. 

defines the location in 1 130 main storage of the 
RTPLOAD program, which is used to load the 1 130 
RTP program. If this parameter is not specified, the 
default value is: 

2(&MACHSIZ - 1024) 

The RTPLOAD program must reside in an area of 
storage that is available between the beginning of the 
buffer pool and the end of main storage, as defined in 
the &MACHSIZ parameter, minus the length of the 
RTPLOAD program. The default value of this 
parameter allows 1024 words for the RTPLOAD 
program. 

Assuming &MACHSIZ=8192, the default value is 
14336. This value is twice the actual 1 130 storage 
address because the value is used in an ORG operation 
and must be in terms of bytes, not 1 130 words. 



RMT Parameters for the 
System/3 RTP Program 



This section describes the parameters used to specify the machine configuration and 
programming options in the assembly of the System/3 remote terminal processor program 
for JES2 MULTI-LEAVING remote job entry. 



Parameter 
&COMP= 



Value 


1 

2 



Explanation 

specifies the type of compression to be applied to all 
data transmitted to the central computer. 
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Parameter Value Explanation 

&COMP= specifies that no compression of duplicate charac- 

(continued) ters and no truncation of trailing blanks is 

performed. 

1 specifies that trailing blanks are truncated. 

2 specifies that compression takes place after trunca- 
tion. Strings of from two to thiry-one blanks are 
compressed to a single byte; strings of from three 
to thirty-one duplicate characters are compressed 
to two bytes. 

&DEBUG= specifies the inclusion or exclusion of certain validity 

1 tests and a main storage dump program in the RTP 

program. 

specifies that support is not to be included. 

1 specifies that support is to be included. 

&DIAL= number specifies the telephone number to be used during 

null string JES2 initialization. The values specified will be 

included on the /*SIGNON card that it assembled into 

&DIAL1= number the RTP program and will be preceded by the key- 

null string word DIAL (unless the default values are used). Each 
specification is a string of up to eight decimal digits. 
If the telephone number is eight or fewer digits, it 
should be specified in the &DIAL parameter. If the 
telephone number is more than eight digits, the left- 
most eight digits are specified in the &DIAL parameter 
and the remaining digits are specified in the &DIAL1 
parameter. 

&MACHSIZ= number specifies the size of System/3 main storage. The value 

8192 specified must be the appropriate specification for the 

System/3 main storage size, specified as follows: 

Value Main Storage Size 

8192 8K 

12288 12K 

16384 16K 

24576 24K 

32768 32K 



&MLBFSIZ= number specifies the size, in bytes, of each JES2 MULTI- 

400 LEAVING buffer. This value must match the 

&MLBFSIZ initialization parameter value used by the 
JES2 program operating with the controlling MVS 
system. 

The parameter &MLBFSIZ is further described in 
Chapter 3. 

&PASSWD= character- specifies the password that is to be used during the 

string sign-on process. The value specified will be included 

null string in the /*SIGNON card that is assembled into the 

System/3 RTP program. The specification must be a 
character string of from one to eight characters. If you 
want blanks, let the parameter default. 
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Parameter 
&PC(«)= 



Value 

number 



&PRTCONS= 



&S3BSCA= 



Explanation 

specifies skip information for the 5203 or 1403 
printer. The n is a number from 1 to 12 that specifies 
the channel. The value specified in this parameter 
determines the print line number to which paper will 
be skipped when the RTP program simulates the 1403 
command "Skip to Channel «." A specification of 
causes no forms movement. 

If this parameter is not specified, the following values 
are used as defaults: 

&PC(1)=1 

&PC(2)=0 

&PC(3)=0 

&PC(4)=0 

&PC(5)=0 

&PC(6)=0 

&PC(7)=0 

&PC(8)=0 

&PC(9)=0 

&PC(10)=0 

&PC(11)=0 

&PC(1 2)=&S3FORML-5 

specifies utilization of the 5203 or 1403 printer as an 
operator's console. 

specifies that the printer will not be used as an 
operator's output console. 

1 specifies that the RTP program will attempt to 
hold operator messages from JES2 until a job has 
completed printing. However, if two or more 
MULTI-LEAVING buffers contain JES2 operator 
messages, the printer will eject a page (skip to 
channel 1), print the JES2 operator messages, 
eject another page, and resume printing the job. 

2 specifies that the RTP program will throw away 
all operator messages while the printer is printing a 
job. While the printer is dormant, it will print any 
received messages. 

Regardless of the setting of this parameter, messages 
temporarily saved on a direct-access volume for a 
remote terminal will be printed to the terminal as a 
job. Thus, they will always appear on the printer, even 
if another console exists. 

If this parameter is specified greater than 0, MULTI- 
LEAVING console support should be specified in the 
RMTnnn parameter at JES2 initialization. 

If &S35471=1, the value of &PRTCONS is ignored 
and assumed to be 0. 

specifies the number of the System/3 BSC adapter to 
be used for RJE communication. 
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Parameter 

&S3BSCA= 

(continued) 



&S3CMDS= 



Value 



&S3FORML= 



&S3NPUNS= 



number 
66 



&S3NRDRS= 



&S30BJDK= 



Explanation 

1 specifies the first BSCA. 

2 specifies the second BSCA. 

The assembled System/3 RTP program uses the 
adapter specified in this parameter, only. 

specifies the inclusion or exclusion of a command 
facility and of commands to assist the System/3 
operator. 

specifies support is not to be included. 

1 specifies that support is to be included. 

The commands that are available with this facility are 
detailed in Operator's Library: OS/VS2 Remote 
Terminals (JES2). 

is an integer greater than or equal to 6 that specifies 
the number of print lines on a page for the continuous 
forms used on the 5203 or 1403 printer. 

specifies the maximum number of jobs that can be 
punched simultaneously at the System/3 remote 
terminal. 

A value of 3 allows simultaneous operation of both 
5424 hoppers and the 1442 hopper as punches. 

If this parameter is specified greater than 1 , additional 
punches should also be specified in the RMTnnn 
parameter at JES2 initialization. 

specifies the maximum number of jobs that can read 
simultaneously from the System/3 remote terminal. 

A value of 3 allows simultaneous operation of both 
5424 and 1442 hoppers as card readers. 

If this parameter is specified greater than 1 , additional 
card readers should also be specified in the KMTnnn 
parameter at JES2 initialization. 

specifies the inclusion or exclusion of the facility to 
punch OS/VS2 object decks. 

specifies support is not to be included. 

1 specifies support is to be included. 

If this facility is to be included, the text transparency 
feature should be present. 

If 1 is specified, each card of an OS/VS2 object deck 
will be expanded and punched into two 96-column 
cards. These cards will be recognized when read by 
the System/3 RTP program. For each two 96-column 
cards read, one OS/VS2 object deck card image will 
be transmitted. 



138 



Parameter 
&S3SIP= 



Value 


1 



&S3TRACE= 



&S3XPAR= 



number 
10 



&S31442= 



&S35424= 



&S35471= 



&S35475= 



Explanation 

specifies usage of those bytes of System/3 main storage 
between X'100' and X'IFF'. 

specifies that the RTP program will use the bytes. 

1 specifies that the bytes will be used by the System/3 
card system initialization program. 

is an integer greater than 1 that specifies the number 
of 4-byte entries in the RTP program's internal error 
message table. 

specifies the presence or absence of the EBCDIC text 
transparency feature. 

specifies that the EBCDIC text transparency feature 
is not present. 

1 specifies that both the central computer's communi- 
cations adapter and the System/3 BSCA have the 
EBCDIC text transparency feature. 

specifies inclusion or exclusion of support for the 1442 
card reader/punch. 

specifies that support is not to be included. 

1 specifies that support is to be included. 

specifies inclusion or exclusion of support for the 
5424 multi-function card unit. 

specifies that support is not to be included. 

1 specifies that support is to be included. 

If this parameter is specified as 0, &S31442 must be 
specified as 1 . 

specifies inclusion or exclusion of support for the 
5471 printer-keyboard for use as an operator's input/ 
output console. 

specifies that support is not to be included. 

1 specifies that support is to be included. 

If console support is desired, MULTI-LEAVING con- 
sole support must be specified in the RMTnnn 
parameter at JES2 initialization. 

Regardless of the specification of this parameter, 
messages from JES2 can print on the printer. Refer 
to the &PRTCONS parameter in this section and to 
the &SPOLMSG parameter in Chapter 3 for additional 
information. 

specifies inclusion or exclusion of support for the 
5475 data entry keyboard on the System/3 for use as 
an operator's console. 

specifies that support is not to be included. 

1 specifies that support is to be included. 
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Parameter Value Explanation 

&S35475= If console support is desired, MULTI-LEAVING con- 

continued) sole support must be specified in the RMTnnn 

parameter at JES2 initialization. 

If &S35471=1, this parameter is ignored. 

&S396COL= specifies inclusion or exclusion of support for the 

1 load-mode punch option. 

specifies that support is not to be included. 

1 specifies that support is to be included. 

If this parameter is specified, the resultant System/3 
RTP program will be capable of receiving the punched 
output of a System/3 RMT generation. 
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RMT Generation under a Production Batch System 

An RMT generation may be executed as part of a batch job stream. Figure 5-2 shows a 
sample job stream for a batch RMT generation. 

RTP program modules usually write messages to the SYSPRINT data set using record 
format FBM with a record length of 121. The data set may be changed to SYSLISTby 
including a SYSLIST DD statement in the RMTGEN step. This will cause the listings 
from the REMOTGEN utility and assembler to be placed on separate data sets. For 
example: 

//GENJOB JOB ... 
//STEP EXEC RMTGEN 
//RMTGEN.SYSLIST DD SYSOUT=A 
//RMTGEN.OPTIONS DD * 



Procedures for Generating RTP Programs 



Input to an RMT generation is read from the card reader after the JES2 parameters have 
been processed. If the JES2 parameter &BSCCPU is specified to include programmable 
RJE support, the following WTOR message is issued: 

twPLACE RMTGEN OPTIONS IN UNIT xxx AND REPLY 'GO' OR REPLY 'CANCEL' 

where xxx is the unit address of the card reader. 

You should make sure that the specified card reader is not being used for any other 
function (a JES2 card reader, for example). You should clear any cards remaining in the 
card reader, load the card reader with the RMT parameters, and reply "go." If no RMT 
generations are being performed, reply "cancel." 



//RMTGENJB JOB (0000,0000), 'GEN REMOTE PROGRAMS' 

// MSGLEVEL=1 

//RMTGEN EXEC RMTGEN 

//RMTGEN.OPTIONS DD * 

$.RMTM20,2 

&RDEV(1)=2560 

&RADR(1)=2 

&UDEV(1)=2560 

&UADR(1)=2 

&WDEV(1)=2152 

&NUMTANK=5 

$.RMTEND 

$.RMT360,3 

&CMPTYPE=3 

&PDEV(2)=1403 

&ADAPT=030 

&WADR(1)=009 

&NUMTANK=7 

&CORESIZ=16 

$.RMTEND 



Figure 5-2. Input Deck for a Batch RMT Generation 
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Processing 



An RMT generation begins by executing the REMOTGEN utility program. This utility 
acts as a monitor and links to the various RMT utility programs that generate the remote 
terminal load decks as follows: 

1. The GENRMT utility program is invoked to read the OPTIONS data set for the 
remote terminal program identification, to select the appropriate standard options 
list for the desired RTP program, and to print the default values to the SYSPRINT 
data set. 

2. The GENRMT utility program reads the overriding options from the OPTIONS data 
set and changes the current values. 

3. When $.UPDATE or $.RMTEND is encountered in the input deck, the remote 
terminal program source module is copied to a temporary data set by the GENRMT 
utility program. During this transfer, the options (as specified in the RMT 
parameters) are used to update the source module. If $. UPDATE is specified, the 
update cards are used to modify the source module. 

4. After the source module is updated, the assembler is invoked by the REMOTGEN 
utility program to assemble the RTP programs in the temporary data set and, except 
for 1130 and System/3 programs, punch the self-loading object decks to the 
SYSPUNCH data set. The 1130 and System/3 assemblies write the object decks to a 
temporary data set. 

5. On return from the assembler, if the program is for the 1130 or System/3, the 
REMOTGEN utility program invokes a postprocessor (LETRRIP or SYS3CNVT, 
respectively) that creates a load-deck image on the SYSPUNCH data set. The output 
of this is one of the following: 

• The RTPLOAD or RTP1 130 load deck for the 1 130 

• A complete load deck for the System/3 without the 5424 Multi-Function Card 
Unit 

• A deck to be further processed for the System/3 with the 5424 Multi-Function 
Card Unit (see "Output" below) 

This procedure is repeated for each RTP program to be generated. 



Completion Codes 



During both the JES2 and RMT generations, the success of the generation process is 
determined and a completion code is returned. Refer to OS/VS Message Library: VS2 
System Codes and OS/VS Message Library: VS2 System Messages for a discussion of the 
completion codes that are returned by the system. 



Output 



The output from an RMT generation is a card deck for each RMT program generated. In 
addition, the GENRMT utility prints an information listing, the RMT parameter default 
values, and the parameter values you specified. Also, a listing of each assembly is 
produced. 

All listings produced by the GENRMT utility and the assembler have the remote terminal 
sign -on identification number at the top of each page. With the exception of loader 
bootstrap cards, all object deck cards have the identification number punched in columns 
74 through 76. 



System/3 96-Column 
Card Output 



The REMOTGEN utility invokes the postprocessor SYS3CVNT to produce the System/3 
object-deck image on the SYSPUNCH data set. The cards created are 80-column cards 
which, if routed (by use of a /*ROUTE card or the $R operator command) to a System/3 



142 



remote terminal utilizing the System/3 starter system, are punched as 96-column 
System/3 load mode cards. They may also be punched locally or remotely as 80-column 
cards (with the punched output of other RMT generations) and later be separated and 
routed to a System/3 starter system, as the punched output of an 80/80 card-to-punch 
job. The utilities IEBPTPCH or IEBGENER may be used for this. (Refer to Operator's 
Library: OS/VS2 Remote Terminals (JES2) for a description of the System/3 starter 
program and to OS/VS Utilities for a description of the utility programs.) 

System/3 96-column load mode cards must be punched in order to use the output of an 
RMT generation on a System/3 if the System/3 configuration includes a 5424 
Multi-Function Card Unit and the RMT parameter $S35424 was specified as 1. The 
80-column cards are loadable on a System/3 only if a 1442 card reader is attached and 
the RMT parameter &S35424 was specified as 0. 

Instead of the System/3 starter system, any JES2 System/3 remote terminal processor 
program generated with &S396COL=l specified may be used to punch RMT generation 
output that is routed to a System/3. 



Input Deck for an RMT Generation 



Figure 5-3 illustrates the generation of RTP programs for a System/360 Model 20 work 
station and for a System/360 (other than a Model 20) or System/370 work station. 



Starting and Stopping Remote Job Entry 



Because teleprocessing lines are never considered active at JES2 initialization, each line 
must be activated by means of a JES2 start command ($S). This command can be issued 
by the operator, entered through a command stream (for example, through the JES2 
initialization deck), entered into a job stream, or entered through the automatic 
command processor. A line is dynamically allocated when activated. A line can be 
deactivated and deallocated using the operator's JES2 stop command ($P). 

A remote device is considered active when its remote station becomes active provided 
that the device is specified for automatic start (by the START subparameter in the 
Rnnn.RDm, Rnnn.PRm, or Rnnn.PUm initialization parameters). Otherwise, the device is 
considered inactive and must be started either by the remote or local operator command. 



Column 
1 

$.RMTM20,2 

&RDEV(1)=2560 

&RADR(1)=2 

&UDEV(1)=2560 

&UADR(1)=2 

&WDEV(1)=2152 

&NUMTANK=5 

$.RMTEND 

$.RMT360,3 

&CMPTYPE=3 

&PDEV(2)=1403 

&ADAPT=030 

&WADR(1)=009 

&NUMTANK=7 

&CORESIZ=16 

$.RMTEND 

Figure 5-3. Input Deck for an RMT Generation 
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For BSC Stations: The first action taken at the nondedicated remote station is the 
submission of a sign-on statement. (Sign-on is ignored for dedicated lines.) The format of 
this statement must be: 



Column 


Description 


1 


/*SIGNON 


16 


REMOTEnn or RMTnnn 


25 


password 1 


73 


password2 



REMOTEnnn (RMTnnn) defines the remote station requesting sign-on. The numbers 
must be left justified with no leading zeros. 

passwordl defines the password established at initialization or changed by the operator 
for that line. If the line has a password, then passwordl is required. To establish 
passwordl, set the LINEnnn JES2 initialization parameter. This password can be changed 
or invoked by the operator with the $T command. 

passwordl defines the password established at initialization that is assigned to each 
terminal. If the terminal has a password, then password2 is required. To establish 
password2, set the RMTnnn JES2 initialization parameter. The password ensures that the 
station signing on is a valid station. 

A sign-off statement is submitted to terminate BSC job stream processing. The format of 
this statement is: 

Column Description 
1 /*SIGNOFF 

For SNA RJE Stations: The operator should issue $S LGN1 to start the JES2/VTAM 
interface and to allow JES2 to begin processing logons from the stations. The $S LGN1 
command should be issued after VTAM has been started. (When VTAM has been started, 
both the network controllers or communication links needed to establish a path to the 
remote station and the physical unit and logical unit associated with the station must be 
activated.) To allow an SNA remote station to log on, the operator must also issue a $S 
LNEn to activate a line to VTAM for the SNA RJE station. 

The SNA RJE stations use the logon command to request a session with JES2. When the 
operator issues LOGON, VTAM notifies JES2 that a logon has been received, and passes 
to JES2 the data sent with the logon command. If the data is acceptable, JES2 establishes 
a session with the logical unit associated with the remote station. 

The syntax of the logon command for each logical unit (LU) is established at JES2 
initialization and VTAM system definition; for example, the "password" included in the 
data sent with LOGON may or may not be required. The operator must be told what 
syntax to use. The default VTAM syntax is: 

LOGON APPLID(JES2) LOGMODE(name) DATA(RMTnnn,password 1 5 password2) 

JES2 is the name that identifies JES2 as an application program. 

LOGMODE(name) indicates a mode table entry that helps JES2 determine some of the 
characteristics of the session with an SNA ASCII terminal. 

DATA specifies the remote station and any valid passwords. 

passwordl authorizes the use of the SNA line associated with it; 
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password2 authorizes the use of the SNA remote terminal associated with it. 

SNA remote stations can use the SIGNOFF statement or the logoff command to end 
SNA RJE processing. ($P LGN1 is used to stop the JES2/VTAM interface.) The logoff 
command, however, has some options that are not provided by the SIGNOFF statement. 
As with the LOGON command, the installation defines the syntax of LOGOFF at JES2 
initialization and VTAM system definition. The default syntax is: 

LOGOFF TYPE(COND/UNCOND) 

TYPE indicates whether a conditional or unconditional logoff is requested. COND 
indicates that the SESSION will be disconnected at the end of any current data 
transmission, and UNCOND indicates that the SESSION will be disconnected 
immediately regardless of the data transmission. 

For more information about LOGON and LOGOFF, refer to OS/VS2 MVS System 
Programming Library: VTAM. For a description of $S LGN1, $P LGN1, and $S LNEn, 
refer to Operator's Library: OS/VS2 JES2 Commands. 



Altering the Sequence of Operations from a Remote Terminal 



Two JES2 options are provided to allow the remote terminal operator to control the 
sequence of operations at the remote terminal. 

During JES2 initialization, the system programmer can specify a delay time, using the 
&WAITIME parameter, which takes effect between printing and punching the output of 
each job. This delay gives the operator the opportunity to ready the card reader and 
change the terminal status to transmit data. JES2 senses this condition and reads the 
input stream before resuming printing or punching. 

When each BSC printer or punch is defined at JES2 initialization, using the Rnnn.PRm or 
Rnnn.PUm parameters, the suspend mode of operation can be specified or negated. If the 
suspend mode is in effect, the remote operator can alter the sequence of operations by 
stopping the output device. When the device is again readied by the operator, JES2 
simulates an interruption by flushing its current I/O buffers and printing the remote 
separator page, if any. JES2 then determines whether the remote card reader is ready. If 
so, the input is read. If not, the highest priority output is selected. This can be 
resumption of the current operation or another data set. The delay must be sufficiently 
long for the terminal to notify JES2 of the stopped device state. The time depends on the 
terminal type. If suspend mode is not in effect, the current operation is resumed after the 
device is readied again. 

For SNA printer or punch devices, JES2 ignores the subparameter for suspend mode in 
the Rnnn.PRm and Rnnn.PUm parameters. Operations will not be suspended 
automatically on a time interval. The operator can suspend a data stream that is being 
sent to the remote terminal; for example, by issuing the $1 command. 



Options for Disconnecting Remote Lines 



At JES2 initialization, the system programmer can use the LINEnn statement to choose 
whether each line for BSC RJE stations is to have the abortive disconnect feature. If the 
feature is selected, a line is automatically disconnected by simulating a $E command 
sequence when the transmission control unit detects a not-ready data set. If the feature is 
not selected, the line will remain active and wait for the data set to be made ready or for 
operator action. The conditions under which a transmission control unit may detect a 
not-ready data set are dependent on line configurations. 
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For both SNA and BSC stations, the system programmer can also cause JES2 to 
automatically disconnect an inactive station by coding a non-zero value into the 
DISCINTV parameter of RMTnnn at JES2 initialization. When this amount of time has 
elapsed with no data sent or received on the line, JES2 will disconnect the line by 
simulating a $E command sequence. 



SMF Accounting Record 



SMF accounting records, types 47, 48, and 49, contain information useful for tracking 
the use of both SNA and BSC remote stations. 

• Type 47 indicates whenever a line is started or a station signs on. 

• Type 48 indicates whenever a line is stopped or a station signs off. It also contains 
statistical information. 

• Type 49 indicates whenever a station uses the wrong password when trying to sign on. 
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CHAPTER 6. MISCELLANEOUS JES2 FACILITIES 



The JES2 patching facility, PTF map, automatic command processing, the flow for 
time-sharing and started tasks, and the multi-access spool are described in this chapter. 

Automatic Command Processing 

The operator may specify from the console or through a local reader that certain 
commands or strings of commands take effect automatically at specific times or at regular 
intervals. The procedures for using the following commands to do this are in Operator's 
Library: OS/VS2 JES2 Commands. 

• Start Automatic ($SA): Starts automatic command processing. 

• Set Automatic ($TA): Displays, specifies, or modifies the strings of commands (the 
"automatic command elements"). This command can also selectively cancel selected 
commands. 

• Cancel Automatic ($CA): Cancels all previously entered automatic commands. 

• Halt Automatic ($ZA): Stops all automatic command processing until it is restarted. 

Typical reasons for using automatic command processing are to provide periodic status 
displays and to cause the operator to. do no more work than necessary for common, 
preset routines or schedules. For example, if it is normal at the installation to do one 
specific kind of processing at 8 a.m., and another 9 a.m. every morning, it is possible to 
preset automatic command processing to issue the operator commands that would 
ordinarily be necessary at those times. 

Writing a Day 's Establish the use of automatic command processing with the &NUMACE parameter at 

Work Scheduler initialization. Enter the commands with the $T operator command or write a program to 

put cards through an internal reader. 

The following statements represent sample cards placed in the initialization deck: 

(1) $TA,T=10.30,'$SLNE1 ,LNE2,LNE3' 

(2) $TA,T= 1 2.30,'$I 1 ,ABC ;TI2 ,XBC ;L=A' 

(3) $TA,T=16.15,'$PLNEl,LNE3;DMRl-9, "PLEASE SIGN OFF ASAP'" 

(4) $TA,T= 1 6.45 ,'$ELNE 1..LNE2 ,LNE3 ' 

These four statements mean the following: 

(1) Start the three remote job entry lines. 

(2) Modify these initiators. 

(3) Prepare to stop the remote job entry lines and give a warning to users who are 
using the system. 

(4) Halt the remote job entry lines. 

The sample cards show various times of the day set aside for routine processing. 

A common source of these commands may be a user-written program for scheduling the 
day's work. This program can use the internal reader to get the commands into the 
subsystem. In writing this program, observe the following considerations: 

• When more than one command is to be executed at approximately the same time, you 
should combine them into one command text entry. 
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• The responses to the command within the text will normally be directed to the in-line 
messages area and to any consoles receiving MCS route code 1 unless you use the 
L=caa operand as described in Operator's Library: OS/VS2 JES2 Commands. 

• Multiple commands with responses to out-of-line area on graphic consoles will 
normally be overlaid too rapidly for the operator to view. Avoid this kind of command 
sequencing. 

• The authority of the internal reader determines which of your command entered 
through it will be valid. See Operator's Library: OS/VS2 JES2 Commands for 
discussion of command authority as it pertains to automatic command processing. 

• The day's work scheduler program should limit the number of automatic command 
entries to a value that does not overload the system consoles or leave insufficient 
resources for status displays. 

• An entire automatic command processing entry must fit on an 80-column card image. 

Limiting When automatic command processing is active, commands entered at system speed 

Considerations (rather than at operator speed) may congest the system. In turn, system responses to the 

commands may flood the console with the response messages. 

If the installation is experiencing difficulty either with congesting the system or flooding 
the console with messages, re-evaluate the mix of commands submitted with automatic 
command processing and try some changes. 

Automatic command processing may also terminate itself prematurely under the 
following conditions: 

• The operator enters the $ZA command to halt automatic command processing and 
then lets 24 hours or more elapse without restarting it. 

• The operator specifies a start time for automatic command processing that is either 
before midnight of the current day or more than 24 hours later than the current 
moment. 

• The system becomes so congested that the automatic commands are delayed 
approximately five minutes. 

Make sure the operator fully understands the procedures for using automatic command 
processing. They are fully outlined in Operator's Library: OS/VS2 JES2 Commands. 

The JES2 Patching Facility 

The JES2 patching facility makes temporary patches to any module in JES2 or to any 
absolute storage address in the address space into which JES2 is loaded. Because these 
patches are valid only until a module is reloaded, they must be applied every time that 
JES2 is started. These patches are applied at the time JES2 is initialized. The patching 
facility statements are submitted to the JES2 initialization data set. 

Modules that are marked refreshable should not be patched because refreshing nullifies 
the effect of the patch. Since pages in the Pageable Link Pack Area (PLPA) are not paged 
out, any patches applied to modules residing in this area will not be effective after the 
page in which the patch was made has been paged in. For this reason, modules in 
SYS1.LPALIB data set (for example, HASPSSSM) must be "fixed" by an entry in the 
SYS1.PARMLIB fixed list before patches are applied by the JES2 patching facility. 
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Rules for Coding 
Patching Statements 



Format of the JES2 
Patching Facility 
Statements 



The JES2 patching facility in the JES2 initialization data set can be specified in either the 
JES2 patching format or in the AMASPZAP format. All patches in the JES2 patching 
format should appear before any AMASPZAP format patches. These two methods for 
patching are explained in the following sections. 

The following conventions are used in the parameter descriptions: 

• Uppercase letters must be coded exactly as shown. 

• Lowercase letters represent variables for which you must substitute specific 
information or specific values. 

The following syntax rules apply to the coding of the parameters. 

• The size of a patching facility statement is 71 bytes. 

• The statements cannot be continued on successive cards. 

• The statements may begin in any column, but the operation name must precede the 
parameters. 

• A statement beginning with an asterisk is a comment statement. 

• There must be at least one blank between the specified operation name and the first 
parameter. 

• All parameters must be separated by at least one blank space. 

The format of the JES2 patch statement is as follows: 
operation csect address data comments 

operation 

defines the operation to be performed as follows: 

REPLACE 

REP 

R 

The data on the statement replaces the data at the location specified by the csect and 
address parameters. 

VERIFY 

VER 

V 

The data on the statement will be compared with the data at the location specified by the 
csect and address parameters. If the data does not compare, an error message is displayed 
in the parameter library list data set; subsequent REP operations are still performed. 
(Note: A verify request will not prevent subsequent REP operations from being 
performed.) 

BASE 
B 

The base, the offset used to adjust address values that are to be specified in any 
subsequent VER and REP statements, is to be modified. This offset is initialized to a 
value which is based upon the distributed CSECT and assembly module relationships of 
JES2; the BASE statement need only be used if this relationship is modified locally. The 
data parameter on the BASE statement is ignored and may be omitted. 
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csect 

specifies the control section (or control block) in which the data to be verified or 
modified is resident. If an asterisk (*) is coded, the CSECT in effect on the previous JES2 
patch statement is used. Figure 6-1 contains a list of the names that can be coded and 
CSECTs to which these names refer. Note that the patch statement name is the CSECT 
name with the first four characters (always HASP) omitted. 

address 

specifies the hexadecimal address of the data to be verified and/or modified. This address 
does not have to be aligned in any way and can consist of one to six digits (with or 
without leading zeros). The address should be taken directly from a JES2 assembler 
listing containing the referenced CSECT. If an asterisk (*) is coded, the address is 
interpreted as 1 greater than the last address reference on the previous JES2 patch 
statement. 

data 

specifies the bytes of data that are to be verified or modified at the specified location. 
The number of bytes of data defined must be specified as a multiple of two hexadecimal 
digits. If desired, the data within the parameter may be separated by commas (never 
blanks). If all the data will not fit into one patch statement (71 bytes), a second patch 
statement must be used. 

If the data specifies a location within a JES2 CSECT, as specified at assembly time, the 
JES2 patch processing routine relocates this data by the base location of the CSECT if 
indicated. This relocation is indicated by following the data to be relocated with the 
name of the CSECT (abbreviated as in csect above) enclosed in parentheses. The address 
specified in the data should be taken directly from a JES2 assembly listing containing the 
referenced CSECT. The data to be relocated should contain at least six hexadecimal digits 
(three bytes), and, if more than six digits are specified only the last eight digits (four 
bytes) are considered in the relocation process. If an asterisk (*) is coded instead of a 
CSECT name, the CSECT in effect for the location of the current patch statement is 
used. 

comments 

follow the last required parameter and its blank delimiter; the rest of the control 
statement space can be used for comments. 



JES2 


AMASPZAP 


CSECT 


Patch Name 


Patch Name 


Referenced 


ABS 


HASPABS 


Absolute Storage Location 


ACCT 


HASPACCT 


HASPACCT 


COMA 


HASPCOMA 


HASPCOMA 


COMM 


HASPCOMM 


HASPCOMM 


CON 


HASPCON 


HASPCON 


INIT 


HASPINIT 


HASPINIT 


MISC 


HASPMISC 


HASPMISC 


NUC 


HASPNUC 


HASPNUC 


PRPU 


HASPPRPU 


HASPPRPU 


RDR 


HASPRDR 


HASPRDR 


RDRO 


HASPRDRO 


HASPRDRO 


RSCN 


HASPRSCN 


HASPRSCN 


RTAM 


HASPRTAM 


HASPRTAM 


SSSM 


HASPSSSM 


HASPSSSM 


SSVT 


HASPSSVT 


Subsystem Vector Table 


XEQ 


HASPXEQ 


HASPXEQ 



Figure 6-1. Patch Name to CSECT Reference 
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The following are examples of JES2 Patching facility statements: 



CORRECT PROGRAMMING ERROR IN HASPRDR 



VER 


RDR 


1E2 


41E00001 VERIFY INSTRUCTION 


REP 


* 


1E2 


4590B258 BAL TO PATCH SPACE 


VER 


NUC 


258 


B258,B25A,B25C,B25E,B260 V ER I FY PATCH SPACE 


REP 


# 


258 


41202000 ADD INSTRUCTION 


REP 


* 


* 


41E00001 REPLACE INSTRUCTION 


REP 

* 


* 


* 


07F9 RETURN 


* 
* 






CORRECT BAD ADDRESS CONSTANT IN HASPPRPU 


VER 


PRPU 


32 E 


58F0C65C VERIFY INSTRUCTION 


REP 


* 


330 


B264 MODIFY DISPLACEMENT 


VER 


NUC 


264 


B264,B266 VERIFY PATCH SPACE 


REP 


* 


264 


00000520 (PRPU) ADDRESS CONSTANT 



BASE 
VER 

REP 

« 

VER 
REP 
REP 



PRPU 



MODIFY BLOCK CHARACTER TABLE TO SLASH 
THE LETTER Z (POSITION 26) AND THE NUMBER ZERO 
(POSITION 27) ON OUTPUT SEPARATORS. 
-A TABLE ENTRY IS 24 BYTES LONG- 

3580 BASE ON TABLE BLOCKA IN HASPPRPU 

270 FFFOFFF0060000C0018003000600 SLASH 

27A 1FC01FC0 Z 



BASE RDR 


0C98 


VER * 


20 


REP * 


20 



288 3FC07FE0C030C030C030C030 

288 3 F C07 F E0C0F0C 1 B0C330C630 

CC30D830F030E0307FE03FCO 

CHANGE MODEL PDDB IN HASPRDR 
TO USE DEFAULT UCS OF P11 



BASE ON MODEL PDDB AT RPDBMODL 
5C5C5C5C CHANGE '****' 

D7F1F140 TO 'P11 ' 



SLASH 
NUMBER 
ZERO 



AMASPZAP Patch 
Statement Formats 



Two statements are required for defining an AMASPZAP patch. Their formats are the 
same as the formats of the control statements for the OS/VS2 AMASPZAP service aid. 
The first statement defines what module you want to change; the second statement 
defines what change you want made to the module. 



The first statement indicates the control section that is to be the object of subsequent 
operations. The format of this section is as follows: 

NAME member csect comments 

NAME 

specifies a keyword that must be coded. 

member 

specifies the member name on the AMASPZAP control statement. This field is ignored on 
an AMASPZAP patch statement, but must be provided for compatibility with the 
AMASPZAP control statement. 



csect 



specifies the control section (or control block) in which the data to be verified or 
modified is resident. While this field is optional on the AMASPZAP control statement, it 
is required on the AMASPZAP patch statement. Figure 6-1 contains a list of the possible 
CSECTs which can be coded. 
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JES2 PTF Map 



comments 

following the last required parameter and its blank delimiter, the rest of the control 
statement space can be used for comments. 

The second statement is used to indicate what operation is to be performed. The format 
of this section is as follows: 

operation offset data comments 

operation 

specifies the operation to be performed as follows: 

REP 

The data on the statement replaces the data at the offset into the CSECT specified on the 
previous NAME statement. 

VERIFY 
VER 

The data on the statement is compared with the data at the offset into the CSECT 
specified on the previous NAME statement. If the data does not compare, an error 
message is displayed in the parameter library list data set. 

BASE 

The base used to adjust offset values that are to be specified in any subsequent VERIFY 
and REP statements is to be modified. This statement should be used when the offsets 
given in the VERIFY and REP statements for a CSECT are to be obtained from an 
assembly listing in which the starting address of the CSECT is not location zero. The data 
parameter on the BASE statement is ignored and may be omitted. 

offset 

specifies the hexadecimal displacement of the data to be verified or modified in the 
specified CSECT. This displacement does not have to be aligned in any way and can 
consist of two, four, or six digits. 

data 

specifies the bytes of data that are to be verified or modified at the specified location. As 
with the offset parameter, the number of bytes of data defined must be specified as a 
multiple of two hexadecimal digits. If desired, the data within the parameter may be 
separated by commas (never blanks), but the number of digits between commas must also 
be a multiple of 2. If all the data will not fit into one AMASPZAP statement (71 bytes), 
another AMASPZAP statement must be used. 

comments 

follow the last required parameter and its blank delimiter, the rest of the control 
statement space can be used for comments. 



During initialization, JES2 constructs a PTF map. With this map, the user can identify 
from a dump which APAR fixes have been applied to the system. The map consists of 
128 bits. When a PTF is generated, the corresponding APARs are assigned to unique bits. 
Part of the fix for an APAR is code that turns on the map bit that represents that APAR. 
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Time-Sharing Logon and Started Task Flow 



Multi-Access Spool 



Time-sharing logon and started system tasks appear to JES2 as special forms of jobs that 
are received from designated internal readers. These jobs are queued in special job classes 
(TSU and STC) and are assigned a message class that is set during JES2 initialization 
(TSUMCLAS and STCMCLAS). They are presented to the converter with parameters 
($ RDROPSU or &RDROPST) established during JES2 initialization. 

The time-sharing message class (TSUMCLAS) becomes the output class for all 
dynamically allocated SYSOUT data sets for which a class it not specified, and becomes 
the message class for all submitted jobs with no MSGCLASS parameter in the JOB 
statement. 

Time-sharing users can dynamically allocate data sets, dynamically deallocate them 
(spinoff), and print them at the time-sharing terminal (OUTPUT command). 



Previous sections have described JES2 functions on a single system (uniprocessor, MP 158, 
or MP 168) operating under a single copy of the MVS control program. It is also possible 
to operate from two to seven such systems (each a uniprocessor or MP) as members of a 
multi-access spool configuration, as shown in Figure 6-2. 



Operator 



Local and 
Remote 
Card Readers 



Local and 
Remote 
Card Readers 



Operator 




Local and 
Remote 
Printers and 
Punches 



Figure 6-2. Two-System Shared JES2 Configuration 
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The operation of each system in the configuration is independent and includes all 
functions previously described for single JES2 systems. That is, each JES2 system can 
read jobs from local and remote card readers, schedule jobs for conversion and execution 
under MVS initiators, print and punch results at local and remote output devices, and 
communicate with operators and time-sharing users. However, all spool volumes and the 
volume containing the SYS1.HASPCKPT data set are used by all system in the 
configuration. 

The systems logically share a common JES2 queue. The workload may be balanced 
among systems by allowing jobs to be executed on whatever system has an idle initiator 
with the correct class, and print or punch on whatever system has an idle device with the 
correct class, routing, setup, and other requirements. 

Because all systems are functionally the same, if one system in the configuration fails, the 
others may continue processing from the common queue. Only work in process on the 
failed system is interrupted; this work may be recovered by a warm start of the failed 
system while other systems continue processing, or, as explained later, by operator 
command on one of the other systems. 

Shared DASD hardware features (two channel switch, two channel switch additional, and 
string switching) are used to access data on all spool and checkpoint volumes. A copy of 
the JES2 queue and other status information (for example, spool space allocation maps) 
is written to the SYS1.HASPCKPT data set for possible warm start, as with a single JES2 
system. This information is available to all systems, one at a time, as needed. 
RESERVE/RELEASE channel commands are used to prevent simultaneous referencing 
and updating of information kept in the SYS1.HASPCKPT data set. 

Each system in the configuration must have at least one channel path to each spool and 
checkpoint volume, and these devices must be specified as SHARED during MVS system 
generation. It is recommended that each CPU of an MP158 system in the configuration 
have a channel path to each shared volume. 

Configuration To use the multi-access spool feature, the initialization parameters &SPOOL and 

&CHKPT must specify the same volumes for all systems in the configuration. To make 
the common spool and checkpoint data compatible, all systems must also specify the 
same values for the &BUFSIZE, &NUMDA, &NUMTGV, &MAXJOBS, &MINJOES, 
&NUMJOES, &TCELSIZ, &RECINCR, &NUMRJE, and &SPOLMSG initialization 
parameters. Because the default values calculated for &NUMJOES, &NUMRJE, 
&MINJOES, and &SPOLMSG are configuration dependent, an inconsistency may 
inadvertently be introduced if these parameters are not specified explicitly at initializa- 
tion. 

For operational consistency, it is recommended that the &TGWARN, &XBATCH, and 
&XBATCHN initialization parameters be specified the same in all systems of the 
configuration. 

It is also recommended that local unit record devices and RJE lines be given unique JES2 
device names over the whole configuration. The &NUMLNES, &NUMPRTS, 
&NUMPUNS, and &NUMRDRS initialization parameters of each JES2 system should be 
specified as the total number of each type of device in the configuration. This allows all 
devices to be attached to one system (with appropriate manual switching) if other 
systems are not operational. 
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Starting the 
Multi-Access Spool 
Configuration 



Similarly, the LINEnn, PRINTERnn, PUNCHn, and READERn initialization parameters 
should be set so that a device has the same name no matter which system it is attached to. 
For example, if a 321 1 printer is one of four local printers on a two-system configuration, 
it could be initialized as: 

PRINTER4UNIT=102 

for one system and: 

PRINTER4 UNIT=302 
for the other, if it were attached to different channels on the two systems. 

A local unit record device or RJE line can only be attached to one system at any instant. 
JES2 initialization detects devices that are not online and places them in a DRAINED 
state. Later, the device may be activated by entering the $P device and VARY OFFLINE 
commands on the system to which it is attached, performing hardware switching, then 
entering the VARY ONLINE and $S device commands on the new system. The $S 
command will fail if no hardware path exists. 

The &NUMRJE initialization parameter must be the same in all systems of the 
configuration, as previously described. This parameter represents the total number of RJE 
lines known to the entire configuration. Each RJE line must have a unique name, no 
matter which system it is attached to. Therefore, the RMTnnn, Rnnn.RDm, Rnnn.PRm, 
and Rnnn.PUm initialization parameters should be specified the same in all JES2 systems 
of a multi-access spool configuration. 

Before the configuration is started, the TOD clocks on each system should be carefully 
synchronized with a single time source. Because this synchronization is externally 
performed and subject to error, the initialization parameter &SYNCTOL is provided to 
specify the maximum error (in seconds) which JES2 should assume. If the synchroniza- 
tion error is actually greater than &SYNCTOL, then JES2 will not be able to detect 
certain illegal operator actions (for example, performing cold start with other systems 
active). On the other hand, certain legal operator actions (for example, warm start after 
system failure) may be disallowed if attempted before &SYNCTOL seconds have elapsed 
since system failure. 

The members of the configuration are specified by the Sn initialization parameters. For 
example: 

51 SID=K158 

52 SID=L168 

defines a two-system configuration where K158 and LI 68 are the SMF system IDs set 
during IPL of the systems. One system must initially do a cold JES2 start with no other 
systems active and must define all members of the configuration. Other members join 
operation by warm start and must also specify identical Sn parameters. A cold start is 
required to change or add members of the configuration. If only one or no Sn parameter 
is specified, JES2 operates as a single system. 

There are three types of warm starts: 

• If a warm start is specified by the operator and JES2 detects that no other members of 
the configuration are active, after operator confirmation a total configuration warm 
start is performed. New spool volumes may be added, all in-process work is recovered, 
and all unused spool space is accounted for, as in single system operation. 
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• A warm start is performed when warm start is specified and other members of the 
configuration are active. The warm-starting system joins the active configuration and 
recovers only work in-process on the system at the time of a failure, if any. No spool 
volumes may be added. 

• Restart for another system is performed when a system has failed and cannot be 
immediately warm-started. The operator enters the $ESYS command on any active 
member of the configuration. In-process work on the specified system is recovered and 
made available for selection by other members of the configuration, subject to system 
affinity for execution restart as discussed later under "Job Submission and Queueing." 

The algorithm for using the common JES2 queues and other information in the 
SYS1.HASPCKPT data set is determined by the &MINHOLD, &MINDORM, and 
&MAXDORM initialization parameters. These need not be the same for all systems in the 
configuration and should be set according to characteristics such as the number of 
members in the configuration relative CPU speeds, and response requirements. See 
Chapter 3 for details. 

Job Submission and In a multi-access spool configuration, jobs enter the common queue from any input 

Queuing source (local or remote) attached to any system in the configuration. Unless special 

actions are taken, jobs are eligible for execution in any system in the configuration, 
selected by priority and the classes of idle initiators as in single-system operation. Started 
tasks and TSO users are an exception: they are executed only in the system in which they 
are entered. However, job queue entries also contain a system affinity for up to seven 
systems on the maximum configuration and may contain an independent mode affinity. 

Individual jobs may be given affinity to one or more systems (less than the total 
configuration) and may be given affinity for independent mode by the SYSAFF= 
keyword on the /*JOBPARM card. Any input device (local or remote) may be set by the 
$T command to give system and/or independent mode affinities to all jobs read from that 
device. The /*JOBPARM card overrides the input device default. 

If a job's affinity is to specific systems in the configuration or to independent mode, the 
job can be selected only by the system specified and only if the mode of the system 
(independent or not) matches that of the job. 

System affinity may be useful for special processing requirements (for example, 
emulation) not available on all system of the configuration. Independent mode may be 
useful for testing new components with selected jobs while in a shared configuration. 

The display commands ($DA, $DN, $DQ, $DJ) indicate (by SMF system ID) the system 
in which a job is active or the system(s) eligible to process a queued job. The $T J and $T 
ALL commands permit affinities of jobs or all jobs with given affinity to be changed. The 
$T SYS command allows a system to be placed in independent mode. The $L SYS 
command displays the states of all systems in the configuration. 

If a system fails and jobs in execution are recovered and requeued for automatic restart 
either by a warm start or the $ E SYS command, those jobs are given affinity only to the 
failed system. If the failed system is unavailable, the operator may change affinity with 
the $T J or $T ALL commands to attempt restart on another system. 

Priority aging is done only by the lowest numbered active system in the configuration. 
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Duplicate job name protection extends to all systems; that is, if a job name matches 
another active in execution anywhere in the configuration, the job is temporarily delayed. 
See the TSO section that follows. 

Output Printed and punched output processing differs very little from single-system operation. 

System affinity does not apply to selection of work from the JOEs. 

Output work is selected by eligible devices, no matter to which system in the 
configuration devices are attached. Selection criteria are output class, routing (local or 
remote number), and set up just as in single systems. The automatic setup algorithm, 
which prevents the same special forms from being requested for more than one local 
printer, operates for all local printers in the configuration. 

The $CJ command entered from any system in the configuration cancels a job active on 
an input or output device attached to another system. 

RJE Configuration for RJE lines was discussed previously (see "Remote Line and Device 

Configuration" in Chapter 4). 

JES2 ensures that the same remote terminal number cannot sign on more than one line 
anywhere in the configuration at any given time. For dedicated lines, the user must 
ensure this uniqueness by proper setting of line and remote initialization parameters as 
previously described. 

The remote operator message queue operates across the entire configuration. That is, any 
remote operator can send messages to any other remote (even if attached to different 
systems) and any central operator can send a message to any remote. 

TSO TSO user IDs are job names to JES2 and, in a multi-access spool configuration, the 

duplicate job name protection extends across the configuration. A TSO logon is rejected 
if a user of the same ID is logged on elsewhere in the configuration. 

Jobs submitted by TSO users may be executed anywhere in the configuration, subject to 
affinities as previously discussed. However, held output data sets are accessible by the 
TSO OUTPUT command by the submitting user regardless of where logged on or where 
the job executed. Messages produced by NOTIFY are also returned to whereever the TSO 
user is logged on or to where the job was submitted from, if the user is no longer logged 
on. 

SMF The SMF type 26 record contains system IDs indicating which systems in the 

configuration performed each major function of processing for a job: input, conversion, 
execution, post-execution, breaking into output elements, and purging. 

The SMF type 6 records contain the ID of the system that processed each element of 
output work. 
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CHAPTER 7. JES2 PERFORMANCE 



This chapter describes four aspects of JES2 performance: 

• Factors affecting JES2 performance 

• How the operator can control the batch job work load 

• Comparison between HASP II Version 4.0 and JES2 performance factors 

• Changing the JES2 property "nonswappable" to "privileged" 

For related information, such as discussion of job output elements (JOEs) and the the use 
of job classes under JES2, refer to Chapter 4. Additional information on JES2 output 
facilities, the external writer and JES2/HASP differences is discussed in Chapter 4 of the 
OS/VS2 Conversion Notebook. 



JES2 Performance Factors 



&BUFSIZE Parameter 



&NOPRCCW 
Parameter 



JES2 performance depends on the careful specification of at least four initialization 
parameters (&BUFSIZE, &NOPRCCW, &NUMJOES, and &NUMCMBS), page alignment 
of JES2 CSECTs, the allocation of sufficient spool space, selection of the spool device(s), 
and using unblocked records for SYSIN and SYSOUT data sets. 

This parameter specifies the size in bytes of each JES2 buffer. The two recommended 
values of &BUFSIZE are a compromise between best performance and optimum device 
utilization: 

• Value of 1960 for spool volumes on 23 14. This value becomes a half page. (A full page 
wastes spool space and will likely increase seek time significantly.) 

• Value of 4008 for spool volumes on 3330. This value becomes a full page, which 
allows three records per 3330 track. 

Note : The 2305 fixed head device is not recommended for holding buffers. 

Avoid reducing the buffer size below 1960, since the CPU time to print the buffers will 
increase. Larger &BUFSIZE values increase performance by requiring increased blocksize. 
However, avoid increasing buffer size excessively, since buffers are not allowed to cross 
page boundaries. A value of 4008 is the maximum. 

This parameter specifies the maximum number of channel command words per channel 
program for local impact printers. The value should be so chosen that all print lines in a 
spool buffer can on average be printed with a single channel command. You can compute 
this value from the formula: 

&NOPRCCW = &BUFSIZE -s- average line length 

Estimate the average line length, allowing for truncation of trailing blanks by JES2. 

If the value is too small, the CPU time for printing increases. If, on the other hand, the 
value is grossly overspecified, the size of the address space increases, requiring more page 
space and potentially more page faults. 



&NUMJOES 
Parameter 



This parameter specifies the number of job output elements (JOEs) to be generated for 
the queueing of work for printers and punches. If the value is set too small, jobs wait a 
considerable time to be eligible for printing or punching. If the value is set too large, the 
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&NUMCMBS 
Parameter 



size of the address spaces increases (because job output elements are in virtual storage), 
and the CPU time and the number of page faults needed to search the elements will 
increase. The default value is 10 times the maximum number of printers and punches, 
both local and remote/This value should keep printers and punches busy without tying 
up too much virtual storage. As a rough approximation, you can determine the starting 
value as 2N JOEs per job, where N is the number of output classes per job. (For further 
discussion of the factors affecting the number of job output elements, see Chapters 3 and 
4.) 

This parameter specifies the number of message buffers for JES2. A value of 24 can serve 
as a starting value. If it proves too small, it can be increased in multiples of 24. If the 
value is too small, the system is slowed because console messages must wait for buffers. If 
the value is too large, too much common service area (CSA) virtual storage becomes 
allocated and is thus unavailable for other uses. As a rough approximation, estimate the 
value for &NUMCMBS as: 

=2 times &MAXPART + the number of typically active readers (local, remote, and 

internal) 

+ the number of typically active printers and punches (local and remote). 



Primary JES2 Spool 
Volume 



If the primary JES2 spool volume (&SPOOL JES2 initialization parameter) is not 
mounted and ready when JES2 is started, a message is issued to request mounting the 
volume, and JES2 is terminated. Because the requested MOUNT command processing 
requires that JES2 be already initialized, the mounting operation is not possible unless 
the operator makes the spool volume ready and reloads the system. To avoid this 
situation, you should include an entry (that specifies the required spool without 
suppressing the mount option) in the VATLSTnn member of SYS1.PARMLIB. VATLST 
processing will then request volume mounting as part of the IPL process. 



Page Alignment of 
JES2 Control Sections 



Alignment of the HASPINIT CSECT on a page boundary is no longer mandatory, 
although it is recommended. The alignment is handled through the linkage editor. Further 
improvement is possible by aligning the other JES2 modules so that CSECTs do not cross 
page boundaries. By this process, page faults can be minimized during JES2 execution. 



Allocation of 
Sufficient Spool 
Space 



JES2 allocates spool space for a job by dividing each spool volume into track groups. A 
track group is a group of DASD tracks whose size is indirectly specified by the 
&NUMTGV parameter. (The &NUMTGV parameter specifies the number of track groups 
per volume, from which JES2 calculates the track group size). JES2 allocates to a job one 
track group at a time. When a given track group is exhausted, the next track group that is 
allocated is the closest one to the last one used. Seek time is therefore minimized. 



As a rough approximation, you can compute spool space by noting that a 2314 pack can 
hold approximately 200,000 lines of output, plus normal input. A 3330 pack can contain 
approximately 700,000 lines of output, plus normal input. (These figures assume that an 
output line contains 120 non-blank characters.) If sufficient spool space is not allocated, 
performance will degrade, since jobs will periodically have to wait for spool space. 



Division of Tracks 



The tracks on a spool volume are divided into track cells, which are sets of JES2 buffers, 
or track records, grouped together in a logical order on a spool volume. The initialization 
parameter &TCELSIZ indicates the number of records in each track cell. When used in 
despooling, each track cell that is to be sent to a printer, rather than each record, can be 
taken from the spool volume in one operation. 
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To use this track-cell method, however, you must specify the track-cell characteristic for 
the data set involved by means of the $$x initialization parameter. You must also specify 
this characteristic for the printer by means of the PRINTERnn parameter. Both the 3800, 
a nonimpact printer, and impact printers can have the track-cell characteristic. 

The track-cell method of despooling can affect the efficiency of both the system and the 
printers. The buffers for a printer with the track-cell characteristic, as well as the channel 
program used to send the data from the buffers to the printer, are fixed in real storage. 
This storage is not used for anything but sending output to the printer; thus, the amount 
of paging necessary in the system's operations is reduced. (The size of this fixed storage 
area depends on the size of each buffer specified in the &BUFSIZE initialization 
parameter.) 

High-speed printers like the 3800 operate more efficiently with the track-cell method 
because they do not have to wait while a channel program is constructed to send output 
to the printer. With the track-cell method, the print processor constructs the channel 
program at the same time as the despooling of a track cell; thus, when the printer finishes 
an operation, the print processor can send the next track cell immediately and start 
constructing the channel program for the next track cell. 

Spool contention may also be reduced for printers when the track-cell method is used. 
When several print processors are taking records from the same spool volume, each print 
processor removes a track cell, rather than one record at a time. This method reduces 
both the number of times each print processor must get access to a spool volume and the 
amount of arm movement needed to remove the records that the print processor needs. 

Specification of &TCELSIZ can potentially leave short track cells at the end of each 
track. These track cells will be allocated to data sets of a SYSOUT class that does not 
have the track-cell characteristic (NOTRKCEL was specified on the $$x parameter). For 
data sets with the track-cell characteristic (TRKCEL was specified), however, these short 
track cells will only be used if the number of records in the cell is at least half the value 
specified for &TCELSIZ. If it is not, these track cells may be wasted within that job's 
track group. 

If the short cells are allocated to a track-cell data set, performance varies during print 
processing because the number of records eligible to be despooled changes dynamically. 
Specification of &TCELSIZ ideally should divide evenly into the number of records on 
all spool devices. 

When choosing a value for &TCELSIZ, note that during print processing the value 
specified for &TCELSIZ is also the number of JES2 buffers that will be fixed into real 
storage (twice as many are fixed when &PRTBOPT=YES is specified); these pages will 
not be available to the rest of the system for the duration of the output. These buffers 
would normally be fixed by the MVS I/O supervisor during print processing; however, to 
reduce the overhead of constantly fixing and freeing these pages, JES2 leaves them fixed. 

Selection of Spool The three types of JES2 spool volumes are the primary spool volume, secondary spool 

Devices volume, and checkpoint spool volume. The primary spool volume contains: 

• JES2 control blocks 

• Job input and output data 

• Spool message queue records (for remote terminals) 
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The secondary spool volume contains: 

• JES2 control blocks 

• Job input and output data 

The checkpoint spool volume contains the checkpoint records (which were formerly 
located on the primary spool volume). These records are in the data set 
SYS1.HASPCKPT. 

When selecting devices for spools, consider that the volume(s) which contain job input 
and output data should preferably go on one or more 3330s. This device type has 
reasonable speed, rotational position sensing and good capacity. For best performance it 
is desirable to dedicate spool volumes (that is, don't share a volume with paging data sets 
or other non-spool data sets), so that JES2 can do ordered seeks. If there is more than 
one spool device, they should be put on separate channels. The channel need not be 
dedicated, however, since JES2 channel utilization is low. 

Because the checkpoint records are in a separate data set, the space allocation for 
spooling can be evenly spread across the primary and secondary spool volumes. This space 
is defined as the first extent of SYS 1. HASP ACE on each of the spool volumes. Note 
that this space on the primary spool volume must be sufficient to provide for the spool 
message queue records. The &BUFSIZE parameter defines the length of each record. The 
spool message queue record area is calculated as &SPOLMSG X &NUMRJE. 

The checkpoint data set, SYS1.HASPCKPT, should be located on a high speed direct 
access device with low activity to improve performance. The JES2 initialization 
parameter, &CHKPT, indicates the volume serial number of the checkpoint volume. The 
checkpoint data set should be allocated as a single extent within one cylinder. JES2 uses 
only the first extent. For further information about space allocation refer to the 
description of SYS1.HASPCKPT in Chapter 2. 



Use of Unblocked 
Records for SYSIN 
and SYSOUT Data 
Sets 



If the installation is using BSAM, it may be undesirable to specify that SYSIN and 
SYSOUT data sets be blocked. Otherwise, the SAM Compatibility Interface will increase 
overhead by unnecessarily deblocking and blocking sets. 



Held Internal 
Readers in JES2 



All internal readers are treated as a single facility. Thus, if one internal reader is held, all 
are held. This can be particularly troublesome if TSO users are submitting jobs and the 
network operator has held the internal readers. This can be overcome by one of these 
operating techniques: 

• All jobs submitted through an internal reader can be assigned a class and that class can 
be held by means of a JES2 parameter library entry or the $HQn operator command. 

• Jobs submitted through an internal reader can use the TYPRUN=HOLD parameter or 
the TYPRUN=JCLHOLD parameter on the JOB card. 

• Jobs submitted through an internal reader can be individually held with the $H J 
operator command. 



How the Operator Can Control the Batch Job Work Load 



It may be a good idea to always have more batch jobs initiated and more time sharing 
users logged on than the number of address spaces that will fit together in real storage. 
The purpose of such over-initiation is to allow the system resources manager (SRM) a 
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varied mixture of swapped-out jobs to choose from whenever any resouce becomes 
under-utilized. On the other hand, when a resource becomes a bottleneck, the SRM can 
remedy the problem by swapping out the heavy resource-using job(s). 

From the resource management point of view, swapping an address space out of real 
storage is an ideal control mechanism, since the associated job immediately stops using 
the three main system resources— CPU, real storage, and I/O paths. The only resource a 
swapped-out address space continues to hold is allocated auxiliary storage. Thus, it may 
be more practical to cause some jobs to be selected, initiated, and swapped out, rather 
than to have them remain unselected on the job queue. 

You may feel that over-initiation may cause less important jobs to compete with and slow 
up the progress of the more important jobs. However, this concern is addressed by the 
SRM's Workload Manager, which tries to ensure that individual jobs are processed 
according to the jobs' PERFORM parameter and related parameters in the IPS. 

The operator can ensure that the system resource manager has a sufficient number and 
variety of jobs to keep the system busy by varying the number of logical initiators and 
the classes from which they dequeue jobs. The JES2 commands that provide this control 
are: start initiator, stop initiator, set initiator, and halt initiator ($s Inn, $p Inn, $t Inn, 
and $z Inn). 

Each logical initiator controls the selection of one job at a time. The maximum number 
of logical initiators is specified by the &MAXPART parameter. During JES2 initializa- 
tion, the Innnn-sublist parameter assigns classes to logical initiators. Each initiator is given 
a status of started or "drained" that is, stopped. 

JES2 indirectly causes an address space to be created for each active logical initiator. The 
operator may activate logical initiators and cause additional batch job address spaces to 
be created by means of the JES2 Start Initiatorcommand, $S Inn. The maximum number 
of logical initiators is limited by the &MAXPART parameter. In a similar manner, the 
operator may "drain" logical initiators and cause termination of their address spaces by 
issuing the JES2 Stop Initiator command, $p Inn. 

The operator can deactivate a logical initiator, but not terminate the address space (which 
will be swapped out), by issuing the halt initiator command, $Z Inn. Some time is saved, 
since the address space need not later be recreated through the start initiator command, 
$S Inn. 

The four commands useful in controlling batch job workload are summarized in Figure 
7-1. For syntax information regarding the $T, $S, $P, and $Z commands, refer to 
Operator's Library: OS/ VS2 JES2 Commands. 

Comparison of HASP II Version 4.0 and JES2 
Performance Factors 

JES2 performance factors in MVS are compared with similar factors in HASP II Version 
4.0 under VS2 Release 1. 

Fixed Storage HASP II Version 4.0 fixes a minimum of three pages to satisfy EXCP requirements of 

VS2 Release 1. It also fixes space for commonly used control blocks. 
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Desired Function 



JES2 Operator Command 



Control the number of batch jobs that are 
executable at the same time by assigning 
classes from which these jobs can be 
selected. 

Activate logical initiators and cause creation 
of additional batch job address spaces. 

Stop ("drain") logical initiators and cause 
termination of batch job address spaces. 

Inactivate a logical initiator, without 
terminating the address space. 



Set Initiator: $T Inn 

Start Initiator: $S Inn 
Stop Initiator: $P Inn 
Halt Initiator: $Z Inn 



Note: The initiator identifier nn represents a one-character or two-character ID. Some 
examples are 1 , 2, cd. 

Figure 7-1. JES2 Commands Useful in Controlling the Batch Job Work Load 



JES2 fixes two pages of its load module, and additionally obtains storage from fixed 
subpool storage for JES2's event control block (ECB) and for the SRB/IOSB needed for 
RELEASE of the checkpoint volume. Pages are also fixed for I/O. 



Region Size 



A large part of JES2 is common with HASP II Version 4.0. Changes in the size from the 
HASP region are not expected to introduce noticeable performance changes. 



Checkpoint Records 



Checkpoint records are not compatible between HASP II Version 4.0 and JES2. 
Therefore neither HASP II Version 4.0 nor JES2 can be warm-started from the other's 
spool pack. 



Spool I/O 



HASP II Version 4.0 uses pseudodevices to process SYSIN and SYSOUT data sets. A 
cross-region POST is issued for I/O when a buffer is full. Spool I/O is organized to 
minimize seek time. 

In JES2, spool I/O is from the job's address space. Pseudodevices are not needed. No 
cross-region POST is needed. Task switching time is reduced. Spool I/O also minimizes 
seek time if the secondary spool volume is not shared with non-spool data sets. 



Changing JES2 Property from Nonswappable to Privileged 



In the generated system, JES2 is automatically marked nonswappable in the program 
properties table. Under the following conditions you may improve performance by 
changing the JES2 attribute from nonswappable to privileged. 

You should consider this modification only if your installation's job stream has both 
these traits: 

1 . Batch jobs only, and 

2. Extended periods during which jobs are neither read in, scheduled, nor written out. 

Do not make JES2 privileged if you plan to do any remote processing, either 
conversational or remote batch. 
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By making JES2 privileged, you can cause the system to swap out JES2, if no JES2 
activity has occurred in a 10-second interval. Such swap-out would permit swap-in of a 
job step awaiting real storage availability. 

The disadvantage of this modification is a short delay to swap in JES2 when it is needed; 
that is, during Job Select, or when the operator issues a JES2 command, a START 
command, or a MOUNT command, or when an internal reader is allocated. 

The method by which you can modify entries in the program properties table is described 
in OS/VS2 System Programming Library: Job Management. 

Questions from JES2 Users 

The following questions have been asked by JES2 users. 

Does JES2 support FCB loading for System/ 360 or System/ 3 70 remote stations? 

If FCB loading capability is indicated for a remote printer through the JES2 
Rnnn.PRm initialization parameter, the same FCB image that would have been loaded 
locally is transmitted to the remote station. If the related printer is 321 1, the image is 
loaded as received by the remote station. If the related printer is a 3203 or 5203, the 
FCB image is stripped of its indexing byte before loading. UCS loading, using a 
stand-alone utility, remains the responsibility of the remote operator. 

Can user-written output writers be invoked in MVS? 

In MVS JES2 spools all SYSOUT data. The OS/MVT writer has been modified to 
operate in MVS, and is called an external writer. IBM supplies a procedure, XWTR, 
which the operator can invoke to start the external writer. All of the documented 
interfaces for user-written output writers for OS/MVT and OS/VS2 Release 1 still 
apply to MVS. The external writer requests spooled data sets from JES2, based upon 
various selection criteria, by means of a formal subsystem interface. User-written 
separator routine interfaces for the External Writer also remain the same for MVS as 
with previous OS releases. (Note that JES2 will not process data sets that specified a 
user-written writer name except by the external writer facility.) 

Will the current HASP MULTI-LEAVING work station programs operate correctly with 
JES2? 

Yes, but with some limitations. The HASP Versions 3.1 and 4.0 work station programs 
can be used with JES2 as a transition aid. The Version 3 System/3 program will 
operate unpredictably if punch jobs with 4-digit job numbers are sent to it. The 
Version 3 and 4 System/360 and Sytem/370 programs will operate unpredictably if an 
FCB image is sent to them. All Version 3 and 4 work station programs will operate 
unpredictably when the new disconnect control record is sent to them at the end of a 
session. It is strongly recommended that all work station programs be regenerated 
from JES2 libraries to realize the benefits of new feature support and to insure that 
the latest maintenance level is obtained. 
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Can JES2-supplied MULTI-LEAVING workstation programs be used with prior versions 
of HASP? 

Yes. But certain new functions (for example, signoff control record and FCB support) 
partly implemented in JES2 are are not supported in prior versions of HASP. 



Does JES2 support the 3781 punch? 

Yes, the JES2 RMTnnn initialization parameter can be used to define a 3780 terminal. 
Then, if a 3781 punch is attached to the terminal, the NUMPU subparameter should 
be set to 1. 



Should the user specify blocked SYSOUT data? 

No, JES2 automatically blocks SYSOUT data. The user should specify DCB 
parameters on the DD card if the executing program requires them. BLKSIZE, 
RECFM, and LRECL should indicate unblocked records where possible. 



What remote terminal support is currently available for the System/ 3? 

The System/3 MULTI-LEAVING Remote Job Entry Work Station (MRJE/WS) 
program feature operates under the Model 6 System or Model 10 Disk System (with or 
without the Dual Programming Feature). MRJE/WS communicates with HASP 
'(Version 3.1 or 4.0) or JES2 over point-to-point (switched or non-switched) 
communication lines via the BSC Adapter. MRJE/WS supports full MULTI-LEAVING 
of reader, console input, console output, printer, and punch data streams. A minimum 
program partition of 8.25K is required. 

A variety of physical devices can be assigned to the logical processors, including disk 
and tape input and output. Individual input and output files need not be defined at 
program load time, but can be dynamically allocated as required during a session. 
Individual printer and punch data sets can be directed to tape or disk; or an entire 
stream can be directed to disk, which facilitates DPF operation and may reduce line 
connect time. 

Hardware configuration and system operation are described in the IBM System/3 
MRJE/WS Support Reference Manual. 



How can you pool remote output devices with JES2? 

JES2 supports logical pooling for remote output devices so that the output devices can 
be used more efficiently. For example, an installation has two or more remote stations 
physically located in the same vicinity and the user wants to be able to submit jobs 
through any of them and not be concerned with which one receives the output. 
Remote work stations 45 and 7 1 can be pooled by specifying the following JES2 
initialization parameter: 

RMT71 ROUTECDE=45 

The output routine code of 45 now applies to both stations. Output is returned to 
either, and the operator at either station can control devices and job output at both 
stations. 
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Responses to operator commands are made to the remote station that enters the 
command unless the response is spooled (message spooling). Spooled responses, like 
other print data sets, are routed to either station. 
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GLOSSARY 



This glossary defines JES2 terms and other data 
processing and communication terms used in this 
publication. For definitions of terms not included in this 
glossary, see IBM Data Processing Glossary, GC20-1699. 

IBM is grateful to the American National Standards 
Institute (ANSI) for permission to reprint its definitions 
from the American National Standard Vocabulary for 
Information Processing (copyright © 1970 by American 
National Standards Institute, Inc.), which was prepared 
by Subcommittee X3K5 on Terminology and Glossary 
of American National Standards Committee X3. A 
complete commentary taken from ANSI is identified by 
an asterisk (*) that appears between the term and the 
beginning of the commentary; a single definition taken 
from ANSI is identified by an asterisk after the item 
number for that definition. 



at which information about the status of a job and the system 
can be recorded so that the job step can be restarted later. 

cold start. (1) The initialization procedure that causes an 
operating system to commence operation. (2) Synonymous with 
initial program load. 



deallocate. To release a resource that is assigned to a specific 
task. 

dedicated. Pertaining to the assignment of a system resource - a 
device, a program, or a whole system - to one application or 
purpose. 

dynamic allocation. Assignment of system resources to a 
program at the time the program is executed rather than at the 
time it is loaded into main storage. 



external writer. In OS/VS2, a program that supports the ability 
to write SYSOUT data in ways and to devices not supported by 
the job entry subsystem. 



address space. The complete range of addresses that is available 
to a programmer. 

allocate. To assign a resource for use in performing a specific 
task. 

automatic mode. The mode of operation in which the setup and 
selection of jobs on a printer is controlled by JES2 rather than 
by the operator through the use of operator commands. 

B 

batch processing. (1) *Pertaining to the technique of executing 
a set of computer programs such that each is completed before 
the next program of the set is started. (2) *Pertaining to the 
sequential input of computer programs or data. (3) *Loosely, 
the execution of computer programs serially. (4) Under TSO, the 
processing of one job step in a region, so called because jobs are 
submitted in a group or batch. 

binary synchronous communication (BSQ. Communication 
using binary synchronous transmission. 

binary synchronous transmission. Data transmission in which 
synchronization of characters is controlled by timing signals 
generated at the sending and receiving stations. 

BSC Binary synchronous communication. 

burst. *To separate continuous-form paper into discrete sheets. 



cataloged data set A data set that is represented in an index, or 
hierarchy of indexes, in the system catalog; the indexes provide 
the means for locating the data set. 

cataloged procedure. A set of job control statements that has 
been placed in a library and that can be retrieved by name. 

checkpoint (1) *A place in a routine where a check, or a 
recording of data for restart purposes, is performed. (2) A point 



FCB. Forms control buffer. 

forms control buffer (FCB). A buffer that is used to store 
vertical formatting information for printing, each position 
corresponding to a line on the form. 

H 

HASP. Houston automatic spooling program. A computer 
program that provides supplementary job management, data 
management, and task management functions such as control of 
job flow, ordering of tasks, and spooling. See also JES2. 

I 

impact printer. *A printer in which printing is the result of 
mechanical impact. 

initial program load (IPL). Synonym for cold start. 

J 

JES2. A functional extension of the HASP II program that 
receives jobs into the system and processes all output data 
produced by the job. 

job class. Any one of a number of job categories that can be 
defined. With the classification of jobs and direction of 
initiator/terminators to initiate specific classes of jobs, it is 
possible to control the mixture of jobs that are performed 
concurrently. 

job entry subsystem (JES). A system facility for spooling, job 
queueing, and managing the scheduler work area. See also JES2. 

job output element (JOE). Information that describes a unit of 
work for the HASP or JES2 output processor and represents that 
unit of work for queuing purposes. 

JOE. Job output element. 
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logical unit (LU). The combination of programming and hard- 
ware of a teleprocessing subsystem that comprises a terminal. 

logoff. (1) The procedure by which a user ends a terminal 
session. (2) In VTAM, a request that a terminal be disconnected 
from a VTAM application program. 

logon. (1) The procedure by which a user begins a terminal 
session. (2) In VTAM, a request that a terminal be connected to 
a VTAM application program. 

M 

multi-access spool configuration. Two to seven systems sharing 
the JES2 input, job, and output queues through the use of 
shared DASD. 



patch. *To modify a routine in a rough or expedient way. 

physical unit (PU). (1) The control unit or cluster controller of 
an SNA terminal. (2) The part of the control unit or cluster 
controller that fulfills the role of a physical unit as defined by 
systems network architecture. 

PTF. Program temporary fix. 



remote job entry (RJE). Submission of job control statements 
and data from a remote terminal, causing the jobs described to 
be scheduled and executed as though encountered in the input 
stream. 

remote station. *Data terminal equipment for communicating 
with a data processing system from a location that is time, space, 

nr Rlp.r.trirallv distant 



or electrically distant. 



remote terminal- (1) A terminal attached to a system through a 
data link. (2) In telephony, a terminal attached through a trunk 
or tieline. 

Remote Terminal Access Method (RTAM). A facility that 
controls operations between the job entry subsystem (JES2 or 
JES3) and remote terminals. 

RJE. Remote job entry. 

RMT generation. Generation of remote work stations for 
remote job entry. 

routing. The assignment of the communications path by which a 
message or telephone call will reach its destination. 

routing code. A code assigned to an operator message and used, 
in systems with multiple console support (MCS), to route the 
message to the proper console. 

RTAM. Remote Terminal Access Method. 

RTP. Remote terminal processor. 



setup. The preparation of a computing system to perform a job 
or job step. Setup is usually performed by an operator and often 
involves performing routine functions, such as mounting tape 
reels and loading card decks. 

SMF. System management facilities. 

SNA. Systems network architecture. 

spooling. The reading and writing of input and output streams 
on auxiliary storage devices, concurrently with job execution, in 
a format convenient for later processing or output operations. 

synchronous data link control (SDLC). A discipline for 
managing synchronous, transparent, serial-by-bit information 
transfer over a communication channel. Transmission exchanges 
may be duplex or half -duplex over switched or nonswitched data 
links. The communication channel configuration may be point- 
to-point, multipoint, or loop. 

system control programming. IBM-supplied programming that is 
fundamental to the operation and maintenance of the system. It 
serves as an interface with program products and user programs 
and is available without additional charge. 

system management facilities (SMF). An optional control 
program feature of OS/360 and OS/VS that provides the means 
for gathering and recording information that can be used to 
evaluate system usage. 

system restart. A restart that allows reuse of previously initial- 
ized input and output work queues. Synonymous with warm 
start. 

system network architecture (SNA). The total description of the 
logical structure, formats, protocols, and operational sequences 
for transmitting information units through the communication 
system. 



Time sharing option (TSO). An option of MVT and OS/VS2 
that provides conversational time sharing from remote terminals. 

TSO. Time sharing option. 

U 

UCS. Universal character set. 

Universal character set (UCS). A printer feature that permits the 
use of a variety of character arrays. 

V 

Virtual Telecommunications Access Method (VTAM). A set of 

programs that control communication between terminals and 
application programs running under DOS/VS, OS/VS 1, and 
OS/VS2. 

VTAM. Virtual Telecommunications Access Method. 

W 

warm start. Synonym for system restart. 



SDLC Synchronous data link control. 

session. (1) The period of time during which a user of a terminal 
can communicate with an interactive system; usually, the elapsed 
time from when a terminal is logged on to the system until it is 
logged off the system. (2) The period of time during which 
programs or devices can communicate with each other. 



170 



INDEX 



&ADAPT, RMT parameter 126 
&BSPACE, initialization parameter 32 
&BSVBOPT, initialization parameter 33 
&BUFSIZE 

as performance factor 159 

initialization parameter 33 
&CCOMCHR, initialization parameter 31,33 
&CCT, RMT parameter 

for Model 20 121 

for other than Model 20 126 
&CHKPT, initialization parameter 34 
&CKPTIME, initialization parameter 34 
&CLOCK, RMT parameter 131 
&CMPTYPE, RMT parameter 

for Model 20 121 

for other than Model 20 126 

for 1 1 30 RTP program 1 3 1 
&COMP, RMT parameter 135 
&CORESIZ, RMT parameter 

for Model 20 121 

for other than Model 20 126 

for 2922 RTP program 126 
&DEBUG 

initialization parameter 34 

RMT parameter 136 
&DEL A Y, RMT parameter 132 
&DELAYTM, initialization parameter 35 
&DIAL, RMT parameter 136 
&DI AL 1 , RMT parameter 136 
&DMNDSET, initialization parameter 36 
&ERRMSGN, RMT parameter 

for Model 20 122 

for other than Model 20 127 
&ESTIME, initialization parameter 36 
&ESTLNCT, initialization parameter 36 
&ESTPUN, initialization parameter 36 
&FULLIST, RMT parameter 

for 1 1 3 loader program 135 

for 1 1 30 RTP program 132 
&JCOPYLM, initialization parameter 39 
&LINECT, initialization parameter 39 
&LINESPD, RMT parameter 

for Model 20 122 

for other than Model 20 127 

for 1 1 30 RTP program 1 3 2 

for 2922 RTP program 125 
&MACHINE, RMT parameter 127 
&MACHSIZ, RMT parameter 

for System/3 RTP program 136 

for 1130 loader program 135 

for 1 130 RTP program 133 
&MAXCLAS, initialization parameter 42 
&MAXDORM, initialization parameter 42 
&MAXJOBS, initialization parameter 42 
&MAXPART, initialization parameter 42 
&MINDORM, initialization parameter 43 
&MINHOLD, initialization parameter 43 
&MINJOES, initialization parameter 43 
&MLBFSIZ 

initialization parameter 44 

RMT parameter 

for Model 20 122 
for other than Model 20 127 
for System/3 RTP program 136 
for 1 1 3 RTP program 1 3 3 
&MSGID, initialization parameter 44 
&NIPFCB, initialization parameter 44 
&NIPUCS, initialization parameter 45 



&NOPRCCW 

as a performance factor 159 

initialization parameter 45 
&NOPUCCW, initialization parameter 45 
&NUMACE, initialization parameter 45 
&NUMBUF, initialization parameter 46 
&NUMBUFS, RMT parameter 

for Model 20 122 

for other than Model 20 1 27 
&NUMCLAS, initialization parameter 47 
&NUMCMBS 

as a performance factor 160 

initialization parameter 47 
&NUMDA, initialization parameter 47 
&NUMINRS, initialization parameter 48 
&NUMJOES 

as a performance factor 159 

initialization parameter 48 
&NUMLNES, initialization parameter 48 
&NUMPRTS, initialization parameter 48 
&NUMPUNS, initialization parameter 49 
&NUMRDRS, initialization parameter 49 
&NUMRJE, initialization parameter 49 
&NUMSMFB, initialization parameter 50 
&NUMTANK, RMT parameter 

for Model 20 122 

for other than Model 20 1 27 
&NUMTGV, initialization parameter 50 
&NUMTPBF, initialization parameter 50 
&OUTPOPT, initialization parameter 5 1 
&OUTXS, initialization parameter 5 1 
&PADR(n), RMT parameter 128 
&PASSWD, RMT parameter 136 
&PC(n), RMT parameter 137 
&PDEV(n), RMT parameter 

for Model 20 123 

for other than Model 20 128 

for 2922 RTP program 1 25 
&PN1442, RMT parameter 133 
&PRFOTL W, RMT parameter 1 3 3 
&PRIDCT, initialization parameter 5 1 
&PRIHIGH, initialization parameter 52 
&PRILOW, initialization parameter 52 
&PRIOOPT, initialization parameter 55 
&PRIRATE, initialization parameter 55 
&PRTBOPT, initialization parameter 55 
&PRTCONS, RMT parameter 

for Model 20 123 

for System/3 RTP program 137 
&PRTFCB, initialization parameter 56 
&PRTRANS, initialization parameter 56 
&PRTSIZE, RMT parameter 

for Model 20 124 

for other than Model 20 129 

for 2922 RTP program 125 
&PRTUCS, initialization parameter 56 
&PRTYOPT, initialization parameter 56 
&PR1132, RMT parameter 133 
&PR1403, RMT parameter 133 
&PUNBOPT, initialization parameter 56 
&RADR(n), RMT parameter 

for Model 20 124 

for other than Model 20 129 

for 2922 RTP program 1 26 
&RCOMCHR, initialization parameter 58 
&RDEV(n), RMT parameter 

for Model 20 124 

for other than Model 20 129 

for 2922 RTP program 1 26 
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&RDROPSL, initialization parameter 59 
&RDROPST, initialization parameter 59 
&RDROPSU, initialization parameter 59 
&RD1442, RMT parameter 133 
&RD2501, RMT parameter 134 
&RECINCR, initialization parameter 63 
&RJOBOPT, initialization parameter 63 
&RPRBOPT, initialization parameter 75 
&RPRI(n), initialization parameter 75 
&RPRT(n), initialization parameter 76 
&RPS, initialization parameter 76 
&RPUBOPT, initialization parameter 76 
&RTPLORG, RMT parameter 

for 1130 loader program 135 

for 1 1 30 RTP program 1 34 
&SID, initialization parameter 77 
&SPOLMSG, initialization parameter 77 
&SPOOL, initialization parameter 30,78 
&STC, initialization parameter 78 
&STDFORM, initialization parameter 82 
&SUBMOD, RMT parameter 

for Model 20 124 

for 2922 RTP program 126 
&SYNCTOL, initialization parameter 82 
&S3BSCA, RMT parameter 137 
&S3CMDS, RMT parameter 138 
&S3FORML, RMT parameter 138 
&S3NPUNS, RMT parameter 138 
&S3NRDRS, RMT parameter 138 
&S30BJDK, RMT parameter 1 38 
&S3SIP, RMT parameter 139 
&S3TRACE, RMT parameter 139 
&S3XPAR, RMT parameter 139 
&S3 1442, RMT parameter 139 
&S35424, RMT parameter 139 
&S35471, RMT parameter 139 
&S35475, RMT parameter 139 
&S396COL, RMT parameter 140 
&TCELSIZ, initialization parameter 82 
&TGWARN, initialization parameter 83 
&TIMEOPT, initialization parameter 83 
&TIMEXS, initiailization parameter 83 
&TPBFSIZ, initialization parameter 83 
&TPIDCT, initialization parameter 84 
&TRANPRN, RMT parameter 134 
&TSU, initialization parameter 78 
&UADR(n), RMT parameter 

for Model 20 125 

for other than Model 20 130 

for 2922 RTP program 126 
&UDEV(n), RMT parameter 

for Model 20 125 

for other than Model 20 130 

for 2922 RTP program 125 
&WADR(1), RMT parameter 1 3 1 
&WAITIME, initialization parameter 84 
&WARNTIM, initialization parameter 85 
&WDEV(1), RMT parameter 

for Model 20 125 

for 2922 RTP program 126 
&WTOSIZE, RMT parameter 

for Model 20 125 

for other than Model 20 131 
&x, initialization parameter 78 
&XBATCH, initialization parameter 86 
&XBATCHN, initialization parameter 86 
&XLIN(n), initialization parameter 86 
&XPARENT, RMT parameter 

for Model 20 125 

for other than Model 20 131 

for 2922 RTP program 126 
&XPRI(n), initialization parameter 87 



5x, initialization parameter 85 



account field scan 
description of 97 
exit from 97 
address space, definition of 169 
allocation, definition of 169 
alternate subsystem, example of 31 
AMASPZAP patching statement 14,15 1 
APAR fixes, identifying applied 152 
ASCII line control characters 41 
automatic commands 

example of processing 147 
limit considerations for 148 
processing of 147-148 
specifying number of active 45 
use in scheduling day's work 147 
automatic mode 

(see also setup mode) 
definition of 169 
description of 108 
printers/punches in 110 
specifying for local card punch 57 
specifying for local card reader 62 
specifying for local printer 54 
specifying for remote card punch 72 
specifying for remote printer 70 



backspace character, specifying 32 
BASE patching statement 149,152 
batch class 

associated with execution batch program 104 

defining 78-81 
batch job 

conversion parameter field for 59 

operator control of work load 162 

sample of generation 10 
batch processing 169 

batch scheduling (see execution batch scheduling) 
binary synchronous communication (BSC) 169 
binary synchronous transmission 169 
BSC remote station 

(see also remote station) 

specifying characteristics of 64-67 
buffering, specifying double 

local card punch 56 

local printer 55 

remote card punch 76 

remote printer 75 
buffers, specifying 

for JES2 33 

number of console message 47 

number of I/O 46 

number of SMF 50 

number of teleprocessing 50 

number required 46 

size of MULTI-LEAVING 44,122 
burst, definition of 169 
burster-trimmer-stacker option 53 



card punch 
local 

(see also local device) 

numbering of 57 

specifying characteristics of 57 

specifying maximum number of 49 
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remote 

identifying forms for 72 
numbering of 72 
specifying characteristics of 72 
card reader 
local 

{see also local device) 

default printer destination for jobs entered at 62 
default punch destination for jobs entered at 63 
numbering of 61 
specifying characteristics of 61 
specifying maximum number of 49 
remote 

default printer destination for jobs entered at 74 
default punch destination for jobs entered at 74 
numbering of 73 
specifying characteristics of 73 
carriage control tape, specifying 
for local printer 53 
for remote printer 70 
initial 56 
cataloged data set, definition of 169 
cataloged procedure, definition of 169 
channel command words, specifying 

maximum number for local card punches 45 
maximum number for local printers 45 
character arrangement table, specifying 45,54 
checkpoint 

definition of 169 
intervals for 34 
checkpoint data set 

recommendation for 34 
specifying volume containing 34 
cold start 

definition of 169 
specifying 24 
comment statement 19 
completion codes 

for JES2 generation 1 1 
for RMT generation 142 
compression/expansion feature, specifying 
for BSC remote station 65 
for SNA remote station 68 
configuration 

internal reader 89 
local device 89 
multi-access spool 154 
remote device 90 
spool 90 
console message buffers 

caution in determining number of 47 
number of 47 
conversion 

controlling 99 
JCL 99 
parameters 99 
conversion parameter field, specifying 
for batch job 59 
for shared task 59 
for TSO logon 59 



deallocation, definition of 169 
dedication 

definition of 169 

line 90 
delay time, specifying 35 
demand setup 36,109 
DESTID, initialization parameter 35 
direct-access volumes, as spool volumes 47 
disconnection, remote line 145 
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83 



distribution libraries 

description of 4 

required 4 

SYS1.AMACLIB 4 

SYS1.AMODGEN 4 

SYS1.AOSH1 4 

SYS1.AOSH2 4 

use in generation 4 
double buffering, specifying 

for local card punch 56 

for local printer 55 

for remote card punch 76 

for remote printer 75 
dynamic allocation, definition of 



error flags, description of 28-29 
execution 

control 100 

time 

associated with priority 75 
issuing message for exceeding 
monitoring 83 
specifying estimation of 36 
execution batch scheduling 

associated with job class 81 

description of 101-105 

examples of 105 

job classes for 102 

operations 103 

preparing for 104 

programs used with 102 

specifying 86 

specifying prefix for 86 

submitting input for 102 
external writer 

definition of 169 

descrip tion of 1,111 



FCB 

definition of 169 
for 3211 printer 113 
loading 165 

specifying for local impact printer 
specifying for remote printer 70 
specifying for 3800 printer 53 
specifying initial for impact printers 
specifying initial for 3800 printers 

forms control buffer {see FCB) 



generating system, use of 4 
generation, JES2 

defining data sets for 5-8 
SYS1.HASPACE 8 
SYS1.HASPCKPT 6 
SYS1.HASPOBJ 6 
SYS1.HASPSRC 5 
description of 3-12 
example of input deck for 10 
preparing for 3-4 
generation, RMT {see RMT generation) 
GENRMT utility program 
description of 4 
use of 142 



53 



56 

44 
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HASP 

comparison with JES2 performance factors 163-164 
checkpoint records 164 
fixed storage 163 
region size 164 
spool I/O 164 
definition of 169 
former generation parameters 14 

MULTI-LEAVING workstation programs under JES2 165 
HASPDOC, description of 1 1 
HASPGEN procedure 11 



impact printer 

definition of 169 
specifying FCB for 53,70 
specifying print chain for 54,56 
indexing, 3211 printer 113 
initial program load, definition of 169 
initialization 13-87 
controlling 13-23 
data set 

contents of 14 
creating 14 
example of 20-21 

for multi-access spool configuration 14 
description of 2,13 
errors 

correction of 28-29 
values used in case of 29 
occurrence of 25 
options 

format of 22 
specifying 22 
using default 24 
parameters 

{see also specific parameter names) 
affecting SNA remote stations 115-116 
conventions used in describing 31-32 
defining data set containing 14 
descriptions of 32-87 
list of 15-18 
initiator, logical 

cataloged procedure 100 
in controlling execution 100 
specifying characteristics of 37 
Innnn, initialization parameter 37 
installing JES2 3-12 
procedures for 9 
internal reader 

configuration 89 
controlling 92 
description of 1,38 
entering j ob through 9 1 
held 162 

maximum number of simultaneous job streams in 89 
overcoming held 38 
procedure for using 92 
specifying characteristics of 38 
specifying number of 48 
starting 45 
INTRDR, initialization parameter 38 
I/O buffers, specifying number 46 
I/O relationships, illustration of 1 



JCT {see job control table) 
JESIIGEN, description of 4,10 
JES2 

application ID for 41 
buffer, specifying size of 33 



definition of 169 

generation {see generation, JES2) 

HASP MULTI-LEAVING workstations under 165 

identifying to VTAM 41 

initialization {see initialization, JES2) 

modifying 1 1 

MULTI-LEAVING workstation programs under HASP 

nonswappable to privileged 164 

option for monitoring 34 

password for 41 

procedures 
basic 21 
contents of 19 
example of updated 23 
updating 19 

processing 89-113 

specifying characteristics of 13-87 
JES2GEN 9 
job class 

assigning 94 

batch 78 

characteristics of jobs in 94 

definition of 169 

example of assigning 94 

for started tasks 78 

for time-sharing tasks 78 

journal, processing for 79 

log, processing for 79 

number of 94 

parameters for specifying processing in 78 

queuing jobs in 79,81 

specifying characteristics of 78-81 

specifying number of 42 

STC 94 

TSU 94 
job control table (JCT) 

selected fields of 98 

use in accounting field scan 97 
job entry subsystem 

{see also JES) 

definition of 169 

primary 30 
job journal, processing for job class 79 
job log, printing for job class 79 
job monitoring 83,100 
job output {see output) 
job output copies, specifying number of 39 
job output element (JOE) 

definition of 169 

description of 106 

minimum number of free 43 

number to be generated 48 

required for 48 
job queuing 

by priority 93 

controlling 93 

in multi-access spool configuration 156 

maximum number of jobs in 42 

of held jobs 93 

queue entry 93 
JOB statement 

accounting field scan 63,97 

exit from scan of 97 

support for PRTY parameter on 56 
job submission 

in multi-access spool configuration 156 

multiple 92 

through internal reader 91 

through local devices 91 

through RJE devices 91 
jobs, specifying number of 42 
JOE (see job output element) 
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LETRRIP, description of 4 
line 

configuration 90 

dedicated 66,90,117 

nondedicated 117 

options for disconnecting 145 

passwords for 144 

specifying characteristics for BSC remote station 40 

specifying characteristics for SNA remote station 40 

specifying largest ID number for 48 
LINEnnn, initialization parameter 40 
LIST control statement 19 
local device 

(see also card punch, card reader, printer) 

configuration 89 

specifying number of 48-49,89 

submitting job through 91 
logical initiator 

cataloged procedure 1 00 

in controlling execution 100 

maximum number defined 42 

specifying characteristics of 37 
logical line, defining 40 

(see also line) 
logical unit (LU), definition of 170 
logoff 

definition of 170 

type for SNA remote station 145 
LOGOFF command, description of 145 
logon, definition of 170 
LOGON command, description of 144 
LOGON 1, initialization parameter 41 
LU definition statement, affecting SNA remote 
station 115-116 



manual mode 

(see also setup mode) 

description of 108-109 

printers/punches in 110 

specifying 

for local card punch 57 
for local card reader 62 
for local printer 54 
for remote card punch 72 
for remote printer 47 
message buffers, specifying number 47 
message class 81,84,108 
message ID, specifying 44 
messages 

number of records reserved for 77 

specifying identifier of 44 
MSTRJCL, changing 25 
multi-access spool configuration 

configuration of 154 

defining initialization data sets for 14 

definition of 170 

general description of 153-154 

identifying system in 77 

job queuing in 156 

job submission in 156 

lock-out warning time in 85 

maximum dormancy in 42 

minimum dormancy in 43 

minimum queue control interval in 43 

output in 157 

providing balanced work load among systems 43 

recommendation for specifying parameters for 154 

remote job entry in 157 

SMF in 157 

starting 26,155 

synchronization tolerance in 82 

TSO in 157 



MULTI-LEAVING 

HASP workstation programs under JES2 165 
JES2 workstation programs under HASP 165 
RJE workstations supported by JES2 1 16-1 17 
specifying buffer size 90 



NOLIST control statement 19 
nonimpact printer (see 3800 printer) 



operator commands 

entering in job stream 101 

identifying in JES2 initialization 33,58 

in controlling initial status of devices 19 

number of 19 

stopping and restarting JES2 19 
operator-controlled mode (see manual mode) 
output 

class assignment 107 

class considerations 107 

controlling system 105 

demand setup 109 

destination 110-111 

estimated punched card 36 
51 



11 
142 

51 



exceeding estimated 
from JES2 generation 
from RMT generation 
held data sets 111 
message for exceeded 
multi-access spool configuration 157 
printer/punch operation for 110 
queuing 106 
routing 110 
selection 108 
separation 112 
setup characteristics of 108 
setup defaults used 109 
specifying SYSOUT class characteristics for 
System/3 96-column card 143 
using print/punch processor in 106 
output writers 

discussion of 106 
user-written 165 



password 

specifying for line 4 1 , 144 
specifying for remote terminal 66 
use in RJE 118 
patching 

CSECT references in 150 
definition of 170 
description of 148-152 
statements for 

AMASPZAP 151 

description of 14,149 

examples of 151 

format of 149 

rules for coding 149 
performance, factors in 159-162 
&BUFSIZE parameter 159 
&NOPRCCW parameter 159 
&NUMCMBS parameter 160 
&NUMJOES parameter 159 
held internal readers 162 
page alignment of control sections 160 
primary JES2 spool volume 160 
selection of spool devices 161 
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sufficient allocation of spool space 160 

use of unblocked records for SYSIN and SYSOUT data 
sets 162 
physical unit (PU), definition of 170 
primary spool volume 

as performance factor 160 

specifying serial number of 78 
print chain 

alias for 1403 and 3211 printers 113 

specifying for local impact printer 54 

specifying for remote impact printer 72 

specifying initial for impact printers 56 
print lines 

maximum number per page 39 

specifying estimation of output 36 

translation of 56 
print train 

alias for 1403 and 3211 printers 113 

specifying for local impact printer 54 

specifying for remote impact printer 72 

specifying initial for impact printers 56 
printer 

local 

numbering of 52 

specifying characteristics of 52 

specifying maximum number of 48 

remote 

numbering of 70 

specifying characteristics of 70 

specifying forms identifier for 82 
PRINTERnn, initialization parameter 52 
priority 

associated with execution time 75 

associated with processing intervals 87 

calculating 95 

job scheduling 95 

output record count associated with 86 

specifying 95 

for jobs entered at local card reader 62 
for jobs entered at remote card reader 74 
for priority aging 52 
priority aging 

limits of 97 

specifying intervals for 55 

specifying priority for 52 
PRIORITY control statement, support for 55 
procedure library, selection 99 
processing 

JES2 2,89-113 

JES2 generation 10 

RMT generation 142 
production batch system, RMT generation 141 
program source modules, changing 9 

IEBUPDTE control cards for 9 
PRTY parameter 

support for 56 

using in job scheduling 95 
PTF 

definition of 170 

map, description of 152 
PU definition statement, affecting SNA remote station 115-1 16 
punch (see card punch) 

punched card output, specifying estimation of 36 
PUNCHnn, initialization parameter 57 



queuing 
job 

by priority 93 

controlling 93 

description of 91 

multi-access spool configuration 156 



of held jobs 93 
queue entry in 93 
output 106 



RDR procedure 92 

reader (see card reader) 

READERnn, initialization parameter 61 

record alternation, specifying 63 

remote card punch (see card punch) 

remote card reader (see card reader) 

remote device 166 

(see also card punch, card reader, printer) 
remote job entry (RJE) 

altering sequence of operations 84 

BSC considerations for 116 

configuration of devices 90 

dedicated lines for 117 

definition of 170 

description of 115-146 

in multi-access spool configuration 157 

MULTI-LEAVING workstations supported 116-117 

overview of 115-118 

SNA considerations for 1 15-1 16 

specifying line characteristics 40 

specifying number of buffers for 50 

starting 143 

stopping 143 

submitting job through 91 
remote line (see line) 
remote printer (see printer) 
remote station 

(see also BSC remote station, SNA remote station) 

altering the sequence of operations from 145 

components of 90 

control of 90 

definition of 115,170 

numbering of 64 

specifying 

characteristics of BSC 64-67 
characteristics of SNA 67-69 
dedicated line for 66,69 
initialization parameters for 14 
number of card punches at 66,69 
number of card readers at 66,69 
number of definitions for 49 
number of printers at 66,69 

tracking the use of 146 
remote terminal, definition of 115,170 
remote terminal access method (RTAM), definition of 170 
remote terminal processor (RTP) programs 

description of 3 

list of 3 

parameters for 121-140 

procedures for generating 141 
REMOTGEN utility program, description of 4,142 
REPLACE patching statement 149,152 
request unit, specifying for SNA remote station 68 
restarting JES2 

after a system failure 27 

after an orderly shutdown 26 
RJE (see remote job entry) 
RMT generation 

completion codes 142 

control cards for 119 

definition of 170 

description of 2,118 

example of input deck for 143 

input deck for 143 

output from 142 

parameters 

(see also specific parameter names) 
conventions used in specifying 121 
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descriptions of 121-140 

for the System/3 RTP program 135-140 

for the System/360 (except Model 20) and System/370 

RTP program 126-131 
for the System/360 Model 20 RTP program 121-125 
for the 1130 loader program 134-135 
for the 1130 RTP program 131-134 
for the 2922 remote work station RTP program 125-126 
specifying 118 
preparing for 3-8 
processing 142 

under a production batch system 141 
update cards 120 
update control cards 120 
RMTnnn, initialization parameter 14,64 
Rnnn.PRm, initialization parameter 70 
Rnnn.PUm, initialization parameter 72 
Rnnn.RDm, initialization parameter 73 
rotational position sensing (RPS), specifying 76 
route code 

caution in use of 54,58 
definition of 170 
specifying 

for BSC remote station 67 
for local card punch 58 
for local printer 54 
for remote card punch 73 
for remote printer 7 1 
for SNA remote station 69 
symbolic name for 35 
routing 

definition of 170 
output 110 
RPS, specifying 76 
RTAM, definition of 170 
RTP programs (see remote terminal processor programs) 



scanning JOB statement, specifying option for 63 

SDLC, definition of 170 

separation 

print separator 112 

print separator card 112 
separator page 

marking for 3800 printer 54 

number of lines on 
for local printer 5 1 
for remote printer 84 
session, definition of 170 
setup 

changes in characteristics 110 

characteristics 108 

definition of 170 
setup mode 

(see also automatic mode, manual mode) 

automatic 108-109 

manual 108-109 
SIGNOFF statement, description of 144 
SIGNON statement, description of 144 
SMF 

account records for remote stations 146 

definition of 170 

in multi-access spool configuration 157 

number of buffers 50 

producing type 6 records for job class 80 

producing type 26 records for job class 80 

replacing ID for 77 
Sn, initialization parameter 77 
SNA, definition of 170 
SNA remote station 

(see also remote station) 

compression/expansion feature for 68 

gaining access to JES 2 115-116 



largest request unit for 68 

line for 69 

messages to console 116 

number of card punches at 69 

number of card readers at 69 

number of printers at 69 

numbering of 67 

password for 69 

specifying characteristics of 67-69 

starting 144 

stopping 145 

terminating session for 68 
spool 

allocation 160 

configuration 90 

contention, reducing 160-161 

devices, selection of 161 

threshold percentage message for 83 
spool volumes 

division of 91 

identification of 90 

number of 47 
spooling, definition of 170 
SPZAP (see AMASPZAP patching statement) 
START command, examples of 30 
started task 

conversion parameter field for 59 

defining job class for 78-81 

discussion of 153 

specifying message class for 8 1 
starting JES2 

after a system failure 27 

after an orderly shutdown 26 

discussion of 91 

for the first time 25 

in a multi-access spool configuration 26,155 
STCMCLAS, initialization parameter 81 
stopping JES 2 91 
subsystems, more than one JES 2 

primary 30 

restrictions for 30 

secondary 30 
SUPERZAP (see AMASPZAP patching statement) 
suspend mode 

for BSC remote stations 145 

for SNA remote stations 145 
synchronous data link control (SDLC), definition of 170 
SYSOUT class 

matching message class 36 

maximum number for printer or punch 47 

specifying for output 107 
SYSOUT data 166 
system control programming 

definition of 170 

use of 4 
system management facilities (see SMF) 
system restart, definition of 170 
System/3 

as remote station 117,166 

RMT parameters for RTP program 1 35-140 

96-column card output 142 
System/360 

Model 20 

as remote station 116 

RMT parameters for RTP program 121-125 

Model 22 

as remote station 117 
RMT parameters for RTP program 1 26-1 3 1 
System/370 

models as remote stations 117 

RMT parameters for RTP program 1 26-1 3 1 
systems network architecture (SNA), definition of 170 
SYS 1 . AOSH 1 , contents of 4 
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SYS1.A0SH2, contents of 4 
SYS1.HASPACE 

description of 8 

JES2 use of 90 

location of 8 

requirements for specification of 8 
SYS1.HASPCKPT 

(see also checkpoint data set) 

as requirement for JES 2 91 

contents of 7 

description of 6-7 

location of 7 

requirements for specification of 6 

space allocation for 7 

specifying volume containing 34 
SYS1.HASPOBJ 

cataloging 6 

contents of 6 

description of 6 

requirements for specification of 6 

space allocation for 6 
SYS1.HASPSRC 

cataloging 6 

contents of 5 

creating 3 

defining 7 

description of 5-6 

requirements for specification of 5 

space allocation for 6 

updating source modules in 9-10 
SYS3CNVT, description of 4 



teleprocessing buffers 

minimum requirement for BSC 50 
minimum requirement for SNA 50 
specifying 50,83 
teleprocessing line, specifying characteristics of 40 
time-sharing option (TSO), definition of 170 
time-sharing tasks 

defining job class for 78-8 1 
logon for 59,153 
specifying message class for 84 
track cell 

description of 90,160-161 
method 

description of 160-161 
performance considerations 160-161 
requirements for 82 
specifying 

characteristic for local printer 53 
characteristic for SYSOUT class , 86 
size of 82 
track groups, number per volume 50 
tracks, subdividing 91,160-161 
TSO logon, conversion parameter field for 59 
TSUMCLAS, initialization parameter 84 



LETRRIP 4 
REMOTGEN 4 
SYS3CNVT 4 



VERIFY patching statement 149,152 

virtual telecommunications access method (see VTAM) 

VTAM 

definition of 170 
LU definition statement for 1 15-1 16 
PU definition statement for 1 15-116 
support for SNA remote stations 1 15-1 16 



warm start 

authorization for 27 
definition of 170 
for j ournaled j obs 27 
for non-journaled jobs 27 
requeuing jobs for 27 
requirements for 27 
specifying 24 



1130 

as remote station 117 

RMT parameters for loader program 131-134 

RMT parameters for RTP program 134-135 
1403 printer, print chain alis for 113 
3211 printer 

indexing for 113 

print chain alias for 113 
3540, writer 112 
3780, support for 166 
3800 printer 

burster option for 53 

improving efficiency of 160-161 

marking separator page for 54 

specifying FCB for 44,53 



UCS, definition of 170 

universal character set (UCS), definition of 170 
update cards 19 
update control cards 
JES2 

description of 9-10 
rules for 9-10 
use of 9-10 
RMT 120 
utility programs, in required distribution libraries 
GENRMT 4 
JESIIGEN 4 
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